Way back in the mists of time (actually, January 2009) I wrote about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
Voici un exemple de carnet de thèse réalisé avec TiddlyWiki 5.0.8-beta.
TiddlyWiki est un très beau logiciel de Jeremy Ruston. Il vous permet, entre autres choses, de prendre des notes, de gérer vos idées, de garder des informations, et d'afficher un tas de choses de la façon que vous choisirez. C'est un outil incroyablement malléable que vous pouvez adapter à la plupart de vos besoins.
Ce TiddlyWiki a été personnalisé pour être utilisé comme un carnet de notes sur la philosophie, récapitulant auteurs, ouvrages, articles, concepts, théories, et notes personnelles. Je l'utilise avec Zotero, un logiciel spécialisé de bibliographie. Les deux sont des projets libres et ouverts. TiddlyWiki peut-être téléchargé sur https://tiddlywiki.com.
buggyj a créé plusieurs plugins utiles, notamment un éditeur HTML WYSIWYG, un calendrier configurable et des listes de tags réagençables par simple glisser-déplacer.
Une collection de diverses personnalisations et macros, par Danielo Rodriguez.
Ceci est mon fichier tiddlywiki de test personnel.
Ici, je posterai les outils et macros que je développe pour ce merveilleux outil. Ainsi, toute l'aide que j'ai reçue de la communauté retourne à la communauté.
Cardo is a standalone, browser-based tool that can be used as a simple task manager, or as a complex Project Management system (and indeed, I do use it this way in my daily work) as well as a fully Wiki-ized personal knowledge store. It runs completely independently in the browser, even without an Internet connection, making it possible to carry around on a USB stick, or to use on the morning commute.
Keeping a journal about your baby is fun. It allows you to keep track of those events in your baby's life and development that are most important to you, and to tell them in your own words. [...]
There are plenty of online services that can help to keep such a diary, but you need to have an internet connection to access them, and you have to trust them to keep your data safe.
Drift is an adaptation of TiddlyWiki with the goal of helping you Collect. Organise. and Grow. your ideas while keeping tab on how they interconnect together and fluidly Drift from one to another.
The 2 main components of Drift are TWCrosslinks and DailyNotes so you never miss an idea
Drift was inspired by TiddlyBlink / Stroll and adapted to fit my needs.
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
FirefoxLinuxMacOther ResourcespluginsEnregistrer les modificationsWindows
Une extension pour Mozilla Firefox qui fluidifie l'utilisation de l'enregistreur HTML5 par défaut de TiddlyWiki, et le rend presque aussi convivial que TiddlyFox. L'extension est conçue pour fonctionner immédiatement, sans configuration.
This wiki gives examples for various filters and their use in the list widget. A good starting point to understand what filters yield which results also is test-filters.js.
This TiddlyWiki, which is still under construction, has several features that together make it lightning fast to find passages, types of passages, themes, people, places and images in the New Testament Gospels. The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
See how the different types of passages are distributed throughout each Gospel.
Hover over passages to see the verses and titles.
Click on a passage to open it and see the themes and other data it mentions.
The themes by passage indexes are lists of the passages in each Gospel, followed by the themes and other data found in the passage. Clicking on a theme calls up a list of all the passages that mention that theme.
The indexes of themes contain lists of links to each theme, person, group, place and image. Clicking on a theme calls up a list of all the passages that mention that theme.
There is a search window hidden in the right hand menu. Use the search window to find passages quickly, by typing things like sower or paralytic. Click the arrows in the upper right of the screen to open the menu and search.
This new textbook from Soren Bjornstad is highly recommended for learning TiddlyWiki. The presentation and design are also a first class example of using TiddlyWiki.
From the site:
Grok TiddlyWiki is a textbook that helps you build a deep, lasting understanding of and proficiency with TiddlyWiki through a combination of detailed explanations, practical exercises, and spaced-repetition reviews of prompts called takeaways.
A collection of helpers by Thomas Elmiger, among them a tweet button macro, a text-stretch solution, a snippet extraction macro and a tiddler that installs a scroll-to-top button via drag-and-drop.
Quick Extensions for TiddlyWiki 5 – […] As I take from the community, I am happy if I can give back. You can use my stuff to do whatever you like, but remember to save a back-up first.
I made this so that some of my friends with absolutely no coding experience could use some of the better features of TW5 without having to learn much. I am hopefully going to continue updating it as I learn new things. There isn't really anything here that isn't available in plenty of other places, but I figured that since I spent a while putting it together and people keep saying that TW needs more documentation I would post it here.
The javascript code is based on the built-in module $:/core/modules/commands/load.js that loads tiddlers from a Tiddlywiki file into a node.js Tiddlywiki instance. This command loads all non-system tiddlers, irrespective of whether they have been modified since last loaded. As a result, all tiddlers in the node.js tiddlers folder will end up with a new modification date.
In contrast, the loadnew command only loads tiddlers that either don't already exist in the tiddlers folder, or have a newer modified date than the existing tiddler.
With a backup strategy that uses a file system snapshot process to preserve historical versions of tiddlers, the loadnew command minimises the sizes of the resulting snapshots.
Tiddlywiki software is prodigious based on javascript which is capable of holding a notepad that can be edited with Internet Explorer or function as a full blog, contained in a single file.
Moments is a beautiful free and responsive theme available for wordpress from here: http://www.s5themes.com/theme/moments/. This is an adaptation of the same for TW5 platform. All the design credits goes to the site and the original designer. If TW5 is going to be here for 25 years, might as well suit up.
Notebook is a clean, uncluttered theme for TiddlyWiki.
The theme is responsive and comes with mobile support through the included notebook-mobile plugin.
Notebook comes with 3 default colour palettes, a grey, beige and dark one. To switch between colour palettes, click the color palette switch button in the top bar.
Notebook uses a custom left sidebar, with another sticky bar at the top of the page (or at the bottom on mobile).
AndroidChromeCommunity EditionsEdgeFirefoxInternet ExploreriOSLinuxMacOperaOther ResourcesPHPSafariEnregistrer les modificationsWindows
NoteSelf est votre version personnelle, privée, et personnalisable de l'expérience utilisateur d'Evernote.
Vous voulez du cloud ? Bien ! Vous n'en voulez pas ? C'est bien aussi ! C'est à vous, c'est votre choix !
Pourquoi ne seriez-vous pas un peu égoïste ?
NoteSelf est le support parfait pour vos idées, vos notes, vos pensées, vos astuces, vos recettes... tout ce que vous voulez !
NoteSelf les stockera, les indexera et les rendra faciles à rechercher, pour que vous les trouviez instantanément quand vous en avez besoin !
Vous connaissez déjà Evernote et vous l'adorez, nous le savons bien. Il est confortable, il se synchronise, il permet la recherche...
Ouah ! Il est presque parfait, mais que pensez-vous de :
La vie privée : tout est stocké sur les serveurs d'Evernote !
La personnalisation : si vous n'aimez pas l'interface d'Evernote, il n'y a rien à faire.
NoteSelf est construit sur la base de TiddlyWiki, un logiciel libre de wiki personnel puissant, gratuit et hautement personnalisable.
Nous en avons tiré le meilleur, son système puissant de personnalisation, et l'avons combiné avec une des meilleures
bases de données embarquées disponibles, PouchDb, pour y apporter les capacités de synchronisation dont vous avez besoin.
Those using multiple different computer platforms (if only PC and Android) knows for certain: You would like to sync notes across computers and thereby be independent of any apps or services. I am concerned at any rate so and so I am constantly looking for the perfect solution.
With TiddlyWiki I found it mostly. As the name suggests, it TiddlyWiki is a Wikisystem. In contrast to all other wikis, TiddlyWiki is a single HTML file that runs in the browser and thus can be used on all modern operating systems. And because there is only one file, it can be very easily via the well-known cloud services (Dropbox, Google Drive, ownCloud) or synchronized with FTP or used on a USB stick.
Un interprète Forth véloce pour le Commodore PET, écrit en langage assembleur 6502. Le TiddlyWiki contenant la documentation du programme est automatiquement engendré à partir du code source : voir https://github.com/chitselb/pettil.
Les objectifs du projet étaient, sans ordre particulier :
faire un interpréteur Forth exécutable sur mon Commodore PET 2001
prendre du plaisir
développer mes compétences en "assembleur 6502"
trouver d'autres personnes intéressées par le projet
ChromeFirefoxOther ResourcespluginsEnregistrer les modifications
Une extension pour Google Chrome et Mozilla Firefox qui fluidifie l'utilisation de l'enregistreur HTML5 par défaut de TiddlyWiki, et le rend presque aussi convivial que TiddlyFox une fois configurée.
For a new job, I decided to set up a personal wiki to keep notes. I wanted to keep it simple, meeting these requirements:
All the data is in a Dropbox folder (so it can be automatically synced between machines)
It must support Markdown syntax
After looking at the options, I settled on TiddlyWiki. I've used "classic TiddlyWiki" before, and liked its simplicity, but I was always a little annoyed with the weird steps you have to go through to save changes. The new version of TiddlyWiki includes support for running it as a real HTTP server, so you can use it just like an online wiki.
But it took me a couple of hours to figure out how to set that up. The TiddlyWiki documentation is not clear ("not clear" is a euphemistic way of saying "terrible"). So, I've written up these instructions in the hope it will spare somebody else all the frustration I had.
I’ve been using TiddlyWiki for this game mainly to record the monsters’ locations and the items that they drop. This is so that when I need a certain item to upgrade/create weapons, I can quickly look it up; which monsters drop it and which quests have those monsters.
As I play the game, as I encounter new information, I just input them into my Shining Ark TiddlyWiki. It’s like I’m building a wiki from scratch. The reason why I don’t just use online wikis is that 1) it’s too easy to get spoiled and 2) sometimes online wikis provide too much information (who cares about the non-gameplay related descriptions that can be found in the game, etc).
In keeping with the general spirit of the TiddlyWiki community, ie, you develop something useful and/or potentially interesting you share it with others, I'm sharing some of the plugins I've developed to go with the new Editor Toolbar. You'll find them and a more extensive discussion of what each does at http://skplugins.tiddlyspot.com/
...is a tool to save and reload sets of Tiddlers. This is already working, The aim is to develop a mechanism to transform these into instant slideshows.
MetaTabs
is a tool which gives you the possibility to attach and show specific information in tabs at the bottom of each Tiddler: ideas, notes, tasks, stories and presentations, comments, annotations and footnotes.
It is inspired by MagicTabs and Tiddlyscholar by Alberto Molina Pérez, which are very elaborated tools that alas do not seem to be in active development any more.
I wanted to change the behaviour in some ways. For example I wanted show tabs only if they have content.
...furthermore there is
an export-plugin,
a footnote-plugin,
and a plugin to rearrange Tiddlers in the StoryRiver
Stroll is a TiddlyWiki adaptation imitating certain features of Roam to help users easily see connections between their notes and navigate between them. Features include:
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
Note: This is an older version of TiddlyServer. A modern version can be referenced here.
TiddlyServer is a special purpose Desktop app, designed to facilitate managing multiple instances of TiddlyWiki running as a server. It does not require internet acess to access the wikis.
TiddlyServer can import both TiddlyWiki files and TiddlyFolder wikis. For each wiki, you specify a prefix to serve it with and the source to import from. It will copy the wikis to its own internal store and begin serving them up at http://localhost:8080/{prefix}/. The export button for each wiki will convert it to a single file wiki.
There is little software that can still inspire me so even after years, as on the first day. This includes TiddlyWiki, the "pocket-wiki". The latter is because the Wiki completely fits into an HTML file, and this HTML file brings everything - JavaScript program logic, CSS appearance and the entire Wiki content as stored records. So a TiddlyWiki file is then sometimes happy times some megabytes in size, but just has the unbeatable advantage that it works just as fast file created locally in a variety of browsers.
TiddlyWiki for Scholars est une personnalisation de TiddlyWiki 5.0.13-beta, que j'ai écrite en pensant à la prise de notes à partir de lectures, mais qui peut servir à d'autres choses. L'idée est de montrer et de faciliter la création des données liées au tiddler courant sans quitter le tiddler.
Ce guide de prise en main de TiddlyWiki vous permettra de débuter sur ce logiciel : rédiger du texte avec la syntaxe wiki, insérer des images, créer des Tiddler, faire une recherche, ajouter des fonctionnalités, et bien d'autres choses.. Bonne lecture ! Sylvain
TWKN will be transferred into TWederation/TiddlyMap format as soon as I am convinced in reliable and secure versioning and multi-user operation in TW format.
Your assistance and support would be highly appreciated.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists. The original site is missing, but a link to an archive is provided.
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
I'm allergic to websites that are highly dependent on JavaScript. I think that JavaScript has many useful applications to add functionality to a site, but content needs to be visible if JavaScript is switched off. I use the NoScript extension for Firefox and surf with pleasure over the Internet without spontaneous things happen that I do not give permission. I love JavaScript on a short leash. More crazier maybe I'm so excited about TiddlyWiki.
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10).
Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5.
To share my knowledge, I made a few guides about these 'modifications'.
The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
I never used Node.js until a couple weeks ago when I wanted to try a TW5 installation on Node and expand my knowledge a bit. I figured someone else may be in the same boat so I wrote it all down
Only Firefox and Safari support MathML at the moment, so the plugin is only useful if you're using one of these browsers. It might be possible to combine this plugin with MathJax to convert MathML to something that other browsers can understand, e.g. HTML+CSS, but I haven't tried this.
Un manuel d'utilisation de TiddlyWiki (en Français) sur BiblioBox, une des variations de la PirateBox, système mobile de transfert et partage de fichiers.
J'ai connu TiddlyWiki à ses débuts en 2004. Je l'utilisais régulièrement comme bloc-notes de façon personnelle ou professionnelle en 2007 et 2012. Mais j'admets avoir ignoré cet outil pendant les deux dernières années. Et voilà que je me suis dit hier : mais pourquoi ne pas mettre TiddlyWiki sur une BiblioBox ? puisque c'est un simple fichier HTML avec du javascript. De plus je connaissais l'existence d'une version serveur pour sauvegarder les modifications en ligne.
This is my work in progress version of TW5, incorporating various features and ideas as and when they intrigue me. To grab any feature you may wish to try, drag the listed tiddlers across to the dropzone of an empty TiddlyWiki 5.0.10-beta
TiddlyWiki est un outil incroyablement souple et polyvalent, conçu et mis au point d'une façon très différente de la plupart des logiciels. Cela peut paraître très difficile à comprendre, jusqu'à ce qu'en un claquement de doigts, il devienne une extension directe de votre cerveau.
Pour commencer par les bases, TiddlyWiki est une application web dédiée à la prise de notes, que vous pouvez obtenir gratuitement, stocker n'importe où, et personnaliser selon vos souhaits. Elle vous servira à conserver, organiser, et partager vos notes de manière inédite en comparaison des traitements de texte et autres outils habituels de prise de notes.
TiddlyWiki privilégie la non-linéarité : le contenu se structure à l'aide de déroulés, de tags, d'hyperliens, et d'autres fonctionnalités spécifiques. Vous pouvez organiser vos notes et y accéder selon votre manière de penser, sans vous sentir contraint par une structure d'organisation prédéfinie.
Vous pouvez utiliser TiddlyWiki sous forme de fichier autonome, affichable et éditable depuis n'importe quel navigateur web, que vous soyez connecté ou déconnecté. Vous pouvez aussi vous en servir comme une application Node.js, à même de synchroniser chacune de vos notes dans un fichier séparé.
Comment faire fonctionner TiddlyWiki chez vous ? Notre conseil est de commencer par lire les textes de présentation ci-dessous, puis de naviguer dans la Table des matières présente dans l'onglet Sommaire de la barre latérale. Ou si vous préférez, vous pouvez suivre nos instructions de démarrage et vous jeter à l'eau !
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
TiddlyWiki n'aurait pas été possible sans le soutien constant de la Communauté. Son attention et ses retours ont permis de comprendre ce qui était attendu de cet outil, et sa passion pour le projet m'a appris que le jeu en valait la chandelle.
Depuis : 5.1.23The action-confirm widget is an action widget that prompts the user for confirmation and invokes other action widgets contained within it only if the user confirms. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-confirm widget is invisible. Any content within it is only processed if the user confirms the action, or the confirmation has been disabled by the $prompt attribute.
Attribute
Description
$message
Optional message displayed to the user when asking for confirmation.
$prompt
Optional flag, set to "no" to disable the prompt for confirmation. Defaults to "yes"
Examples
Here is an example of a button that asks the user for confirmation, before deleting the caption and tags fields of the current tiddler:
<$button>
<$action-confirm $message="Do you wish to delete the caption and tags?">
<$action-deletefield caption tags/>
Delete "caption" and "tags"
</$action-confirm>
</$button>
Affichera ceci :
Here is an example of a button that uses the optional $prompt attribute to control whether to prompt the user before deleting the text field of the tiddler HelloThere:
<$button>
<$action-confirm $message="Do you wish to delete the text field?" $prompt={{$:/state/promptUser}}>
<$action-deletefield $tiddler="HelloThere" $field="text"/>
</$action-confirm>
Delete text from ~HelloThere
</$button>
The $action-createtiddler widget is an action widget that creates new tiddlers. Action widgets are used within triggering widgets such as the ButtonWidget.
The new tiddler is not automatically displayed in the story river
The title of the new tiddler is made available for subsequent operations
Content and Attributes
The action-createtiddler widget is invisible.
Attribute
Description
$basetitle
The initial title that will be attempted. If a tiddler with that title already exists, then a numerical counter is added to the title and incremented until it is unique
$savetitle
. Utilisez ActionCreateTiddlerWidget Example 5 à la place A text reference identifying a field or index into which the title of the newly created tiddler will be stored after it is created
$savedrafttitle
. Utilisez ActionCreateTiddlerWidget Example 5 à la place A text reference identifying a field or index into which the draft title associated with the newly created tiddler will be stored after it is created. This is useful when using a sequence of action widgets to create a new tiddler, put it into edit mode, and position it within the list of its parent tag
$timestamp
Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no"
$template
Depuis : 5.1.22 The title of a template tiddler, that will be used to create a new tiddler
$overwrite
Depuis : 5.1.22 If set to "yes", it will overwrite existing tiddlers. Be careful!
{any attributes not starting with $}
Each attribute name specifies a field to be created in the new tiddler
Variables
Depuis : 5.2.0 The content of the $action-createtiddler widget is executed after the new tiddler has been created. The title of the newly created tiddler is stored in the variable createTiddler-title.
This variable only exists to have feature parity with the deprecated parameters. It contains the title of a "draft tiddler"
Examples
Caption for new button: <$edit-text tiddler="$:/state/new-button-caption" tag="input" default=""/>
<$button>
<$action-createtiddler $basetitle="Homemade Button" tags="$:/tags/PageControls" text={{$:/state/new-button-caption}}>
<$action-navigate $to=<<createTiddler-title>>/>
</$action-createtiddler>
Create a new non-functional page control button and open the tiddler
</$button>
Affichera ceci :
Caption for new button:
This example will create "New Tiddler", "New Tiddler 1", " New Tiddler 2" and so on
The action-deletefield widget is an action widget that deletes specified fields of a tiddler. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-deletefield widget is invisible. Any content within it is ignored.
Attribute
Description
$tiddler
The title of the tiddler whose fields are to be modified (if not provided defaults to the current tiddler)
$field
Optional name of a field to delete
{any attributes not starting with $}
Each attribute name specifies a field to be deleted. The attribute value is ignored and need not be specified
Examples
Here is an example of a button that deletes the caption and tags fields of the current tiddler:
<$button>
<$action-deletefield caption tags/>
Delete "caption" and "tags"
</$button>
Affichera ceci :
Here is an example of a button that deletes the modified date and tags fields of the tiddler HelloThere:
<$button>
<$action-deletefield $tiddler="HelloThere" modified tags/>
Delete "modified" and "tags" from ~HelloThere
</$button>
Affichera ceci :
Here is an example of a button that uses the optional $field attribute to delete the text field of the tiddler HelloThere:
<$button>
<$action-deletefield $tiddler="HelloThere" $field="text"/>
Delete text from ~HelloThere
</$button>
The action-listops widget is an action widget that manipulates user lists in any field or data index. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-listops widget is invisible. Any content within it is ignored.
Attribute
Description
$tiddler
The title of the tiddler whose lists are to be modified (if not provided defaults to the current tiddler)
$field
The name of a field to be manipulated as a list (defaults to 'list')
$index
Optional index of a property in a data tiddler index to be manipulated as a list
$filter
An optional filter expression, the output of which will be saved to the field/index being manipulated
$subfilter
An optional subfilter expression, which takes the list being manipulated as input, and saves the modified list back to the field/index being manipulated
$tags
An optional subfilter expression, which takes the tags field of the target tiddler as input, and saves the modified list of tags back to the tags field
Note on subfilter expressions
If the manipulation depends on the current contents of the list, e.g. when using the toggle operator to toggle the presence of an element, the Filter Run would be prefixed with the + / :andfilter run prefix so that it properly receives the list as input.
The above widget will toggle the presence of the element List Item in the field list of the current tiddler, removing or adding the element as necessary.
Similarly, if an element is to always be removed when it is present, the - / :exceptfilter run prefix can be used. Both of the following yield the same result:
The short form is more convenient, but the long form is useful for live-debugging complicated $subfilter values using the filter tab of $:/AdvancedSearch. By using $:/AdvancedSearch, the Filter Expression can be tested before using action-listops to modify actual tiddler fields. For this use case, the all[current] portion of the expression needs to be changed to select the proper test tiddler.
Using $tags or $subfilter
Tagging is implemented using a tiddler's 'tags' field, so appending the tags "abc" and "123" using the $tags attribute like this:
<$action-listops $tags="abc 123"/>
is mostly equivalent to using $subfilter along with "tags" for the value of $field:
In general, ActionSetFieldWidget is better for setting multiple fields at once and for replacing the value of a field, which can also be a list. The ActionListopsWidget is better for modifying a list field based on the existing list and for using a Filter Expression to derive the value of the field.
The ActionSetFieldWidget sets the value of a field using $field and $value attribute pairs or attributes that do not start with a $. A single ActionSetFieldWidget can be used to set any number of fields of a single tiddler.
The ActionListopsWidget replaces or modifies a single field's value using filter expressions.
The following widgets are functionally equivalent:
Note that abc 123 in the first two cases is a literal string that is assigned to the field myfield, but in the third case a filter expression which evaluates to the same string.
Extended Filter Operators
A number of Extended Listops Filters are necessary for the manipulation of lists. These operators have been designed primarily for use in subfilter expressions whereby the modified current list is returned in place of the current list.
Notes on de-duplication
In some cases, there may occur unexpected de-duplication of lists.
Assignments to the list field
When assigning filter results to the list field (default), the generated list is automatically de-duplicated, so
<$action-listops $filter="[[1]] :and[[1]]"/>
will result in the list field of the current tiddler containing the string 1, but not 1 1.
Input to the subfilter expression
The input to the subfilter expression in the $subfilter attribute is also de-duplicated. If you rely on lists containing duplicates, consider using this alternative using the $filter attribute:
The enlist Operator with raw suffix will enlist the list saved in myfield of the current tiddler without de-duplication, while e.g. the list Operator will always de-duplicate. The widget then adds the item abc – whether or not it is already included in the list – and replaces the original list in myfield.
In this example we shall append and remove items from a list in an ordinary field (myfield) of this tiddler (the default) and sort the resultant list. We shall then remove some of the appended items and sort the resulting list in reverse order.
<$button>
<$action-listops $field="myfield" $subfilter="-efg ijk xyz [[this is a title]] +[sort[]]"/>
Mangle List
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="-xyz -[[this is a title]] +[!sort[]]"/>
Unmangle List
</$button>
<$list filter="[list[!!myfield]]">
</$list>
Affichera ceci :
The following example toggles the tag Examples for the current tiddler.
<$button>
<$action-listops $tags="+[toggle[Examples]]"/>
Toggle 'Examples' tag
</$button>
Affichera ceci :
In this example we shall append a few tags to the 'tags' field of this tiddler (the default). We shall then remove some of the appended tags.
<$button>
<$action-listops $tags="+[append{Days of the Week!!short}] $:/tag1 $:/tag2 $:/tag3"/>
Populate 'tags'
</$button>
<$button>
<$action-listops $tags="+[!remove:2{!!tags}]"/>
Remove Last Two Tags
</$button>
<$button>
<$action-listops $tags="+[!prefix[$:/]]"/>
Remove System Tags
</$button>
<$button>
<$action-listops $tags="-Mon -Tue"/>
Remove Mon and Tue
</$button>
<$button>
<$action-listops $tags="+[prefix[$:/]] ActionWidgets Widgets"/>
Remove User Tags
</$button>
<$button>
<$action-listops $tags="+[[]] ActionWidgets Widgets"/>
Clear Tags
</$button>
<$list filter="[list[!!tags]]">
</$list>
Depuis : 5.1.23 The action-log widget is an action widget that can be used to output debugging information to the JavaScript console supported by most browsers. This can be useful because otherwise it is difficult to observe what is going on within a sequence of actions.
The action-log widget is invisible. Any content within it is ignored.
When the actions are invoked, the names and values of all attributes are logged to the JavaScript console.
In addition there are optional attributes that can be used:
Optional Attribute
Description
$$filter
All variables matching this filter will also be logged.
$$message
A message to display as the title of the information logged. Useful when several action-log widgets are used in sequence.
$$all
Set to "yes" to log all variables in a collapsed table. Note that if there is nothing specified to log, all variables are always logged instead.
A handy tip if an action widget is not behaving as expected is to temporarily change it to an <$action-log> widget so that the attributes can be observed.
The action-navigate widget is invisible. Any content within it is ignored.
Attribute
Description
$to
The title of the target tiddler for the navigation (if not provided defaults to the current tiddler
$scroll
Optional parameter determining whether the navigation will also cause a scroll to the target tiddler (see below)
Scroll handling
The optional $scroll attribute can be set to "yes" to force scrolling to occur to bring the target tiddler into view. If set to "no" then scrolling does not occur. If the $scroll attribute is omitted then scrolling occurs unless either:
the control key is pressed
the action was initiated with the middle mouse button (if available)
Note that if navigating to multiple tiddlers at once you should use the same $scroll setting for all of them.
Examples
Here is an example of button that navigates to two different tiddlers at once:
The action-popup widget is an action widget that triggers the display of a popup defined via a state tiddler, or clears all displayed popups. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-popup widget is invisible. Any content within it is ignored.
Attribute
Description
$state
The title of the state tiddler for the popup
$coords
Optional coordinates for the handle to which popup is positioned (see Coordinate Systems for the supported formats)
$floating
Depuis : 5.2.0 Optional. Defaults to no. Set to yes to create a popup that must be closed explicitly.
Depuis : 5.1.23 If the $coords attribute is missing or empty then all popups are cancelled. Depuis : 5.2.4 The $coords attribute supports absolute and relative coordinates. See Coordinate Systems for more information.
Delete the state tiddler for a floating popup to close it.
Examples
Here is an example of button that triggers the "more" button in the sidebar "Tools" tab. You may need to scroll to see the popup
The action-setfield widget is an action widget that assigns values to the fields of a tiddler. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-setfield widget is invisible. Any content within it is ignored.
Attribute
Description
$tiddler
The title of the tiddler whose fields are to be modified (if not provided defaults to the current tiddler)
$field
Optional name of a field to be assigned the $value attribute
$index
Optional index of a property in a data tiddler to be assigned the $value attribute
$value
The value to be assigned to the field or index identified by the $field or $index attribute. If neither is specified then the value is assigned to the text field. If no value is specified, $field or $index will be deleted.
$timestamp
Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no"
{any attributes not starting with $}
Each attribute name specifies a field to be modified with the attribute value providing the value to assign to the field
Examples
Here is an example of a pair of buttons that open the control panel directly to specified tabs. They work by using action-setfield to set the state tiddler for the control panel tabs.
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Appearance"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Appearance" tab
</$button>
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Settings"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Settings" tab
</$button>
Affichera ceci :
Here is an example of a button that assigns tags and fields to the tiddler HelloThere, and then navigates to it and opens the tiddler info panel on the "Fields" tab:
Here is an example of a button that opens the control panel directly to the "Appearance" tabs:
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" $field="text" $value="$:/core/ui/ControlPanel/Appearance"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Appearance" tab
</$button>
The action-setmultiplefields widget is an action widget that assigns multiple fields to a tiddler where the names and values of the fields are specified as separate filters. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-setmultiplefields widget is invisible. Any content within it is ignored.
Attribute
Description
$tiddler
Optional title of the tiddler to modify (defaults to the current tiddler)
$fields
Optional filter evaluating to the names of a list of fields to assign. Either $fields or $indexes must be specified
$indexes
Optional filter evaluating to the names of a list of indexes to assign. Either $fields or $indexes must be specified
$values
Filter evaluating to the values to be assigned to the fields or indexes
$timestamp
Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no"
Examples
Here is an example of button that uses the data in Days of the Week to assign fields day-Monday, day-Tuesday etc. to the tiddler "HelloThere":
<$button>
<$action-setmultiplefields $tiddler="HelloThere" $fields="[list[Days of the Week]addprefix[day-]]" $values="[list[Days of the Week]]"/>
Click me!
</$button>
The variable actionTiddler is used in subtly different ways by different widgets:
Within the actions string of the DroppableWidget, the actionTiddler variable contains the title of the tiddler being dropped.
Within the startactions and endactions string of the DroppableWidget, the actionTiddler variable contains a quoted Title List of all of the titles being dragged.
Depuis : 5.2.0 The default behaviour of action widgets has some peculiarities that often cause confusion. There is now an improved mode that simplifies how things work, but due to BackwardsCompatibility constraints, it must be explicitly engaged in order to take advantage of it.
The peculiarities relate to the way that the results of previous action widgets are available to subsequent action widgets. By default, action widgets are refreshed before each execution which ensure that they reflect the results of previous actions. However, ordinary widgets are not updated in the same way.
In the following contrived example, a button triggers a series of actions that should result in the string foo being assigned to the text field of the tiddler ActionTestTiddler. However, it fails to produce the expected result because the <$set> widget is not refreshed with the new value of ActionTestTiddler after the execution of the first <$action-setfield> widget.
\define actions()
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value="FOO"/>
<$set name="newvalue" value={{{ [{ActionTestTiddler}lowercase[]] }}}>
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value=<<newvalue>>/>
</$set>
\end
Current value of ActionTestTiddler: {{ActionTestTiddler}}
<$button actions=<<actions>>>
Click me
</$button>
The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scope that includes the variable tv-action-refresh-policy set to the value always. (The default value for tv-action-refresh-policy is once).
The assignment can be done within an action string, or via a local variable declaration containing the widget triggering the action.
Do not attempt to set tv-action-refresh-policy globally; the core will only work correctly with the default setting
The example above works as expected with the addition of tv-action-refresh-policy:
\define tv-action-refresh-policy() always
\define actions()
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value="FOO"/>
<$set name="newvalue" value={{{ [{ActionTestTiddler}lowercase[]] }}}>
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value=<<newvalue>>/>
</$set>
\end
Current value of ActionTestTiddler: {{ActionTestTiddler}}
<$button actions=<<actions>>>
Click me
</$button>
Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that trigger those actions (for example, the ButtonWidget).
Placing them within an action string attribute (typically called actions) on the triggering widget (this is the preferred way)
Embedding the actions within the triggering widget (an older technique that is now deprecated)
Using action string attributes
The action widgets are passed as a string to the actions attribute of the triggering widget. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
The action widgets need not be immediate children of their triggering widget, but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
Depuis : 5.2.0 The default behaviour of action widgets has some peculiarities that often cause confusion. There is now an improved mode that simplifies how things work, but due to BackwardsCompatibility constraints, it must be explicitly engaged in order to take advantage of it.
The peculiarities relate to the way that the results of previous action widgets are available to subsequent action widgets. By default, action widgets are refreshed before each execution which ensure that they reflect the results of previous actions. However, ordinary widgets are not updated in the same way.
In the following contrived example, a button triggers a series of actions that should result in the string foo being assigned to the text field of the tiddler ActionTestTiddler. However, it fails to produce the expected result because the <$set> widget is not refreshed with the new value of ActionTestTiddler after the execution of the first <$action-setfield> widget.
\define actions()
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value="FOO"/>
<$set name="newvalue" value={{{ [{ActionTestTiddler}lowercase[]] }}}>
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value=<<newvalue>>/>
</$set>
\end
Current value of ActionTestTiddler: {{ActionTestTiddler}}
<$button actions=<<actions>>>
Click me
</$button>
The new behaviour avoids these problems by refreshing all widgets before execution, not just action widgets. It is engaged by running the actions in a scope that includes the variable tv-action-refresh-policy set to the value always. (The default value for tv-action-refresh-policy is once).
The assignment can be done within an action string, or via a local variable declaration containing the widget triggering the action.
Do not attempt to set tv-action-refresh-policy globally; the core will only work correctly with the default setting
The example above works as expected with the addition of tv-action-refresh-policy:
\define tv-action-refresh-policy() always
\define actions()
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value="FOO"/>
<$set name="newvalue" value={{{ [{ActionTestTiddler}lowercase[]] }}}>
<$action-setfield $tiddler="ActionTestTiddler" $field="text" $value=<<newvalue>>/>
</$set>
\end
Current value of ActionTestTiddler: {{ActionTestTiddler}}
<$button actions=<<actions>>>
Click me
</$button>
The standard mechanisms in TiddlyWiki for creating Table-of-Contents are macros known collectively as "toc" macros (click on link to learn more about macros). They use Tagging as their means of creating relationships, so be sure to review the Tagging topic tiddler if tagging is a new concept for you.
A customisable table of contents can be added to the sidebar with the following steps:
Add a list-after field with the text $:/core/ui/SideBar/Open
Add entries to the table of contents by creating tiddlers tagged TableOfContents. An easy way is to choose new here from the tiddler toolbar of the TableOfContents tiddler.
(if you don't see the "new here" button, click on the down arrow to see more menu options.)
To create child tiddlers (tiddlers that come below other tiddlers), tag them with the name of the parent tiddler.
Notez que l'URL src est passée sans protocole (ie "http" or "https"). De cette façon, cela fonctionne que les sites soient sur un domaine en HTTP ou en HTTPS. Si vous voulez aussi que le bouton Twitter fonctionne en utilisant TiddlyWiki horsligne par une URL "file://", vous devrez ajouter manuellement le protocole. Par exemple:
À mesure que les structures à l'intérieur de vos documents TiddlyWiki se complexifient, il peut être difficile de conserver la cohérence des titres des tiddlers. Par exemple, faut-il définir les termes au pluriel ou au singulier ? Avec la convention « Camel case » ou en séparant les mots ?
Fixer une politique formelle concernant les titres peuvent aider à réduire les risques de confusion. Par exemple, la politique de titres de ce wiki sont :
Utilisation de mots simples en minuscules pour les tags
Une politique qui inclurait la règle ci-dessous pourrait s'appliquer à vos propres wikis :
Utliisation du préfixe $:/_ pour tous les tiddlers système que vous créez pour être sûr de les retrouver en haut de la liste des tiddlers système de la barre latérale.
Alerts are displayed as yellow boxes overlaying the main TiddlyWiki window. Each one corresponds to a tiddler with the tag $:/tags/Alert. Clicking the delete icon on an alert deletes the corresponding tiddler.
Here's a demo .
Alert tiddlers should have the following fields:
Field
Description
title
By default, alert titles have the prefix $:/temp/alerts/
text
The text of the alert message
modified
Date of the alert (used for ordering the alerts on screen)
all non-existent tiddlers to which there is at least one hard link
no
orphans
all tiddlers to which there are no hard links
by title
shadows
all the shadow tiddlers that exist, including any that have been overridden with non-shadow tiddlers
no
tags
all the tags in use on non-shadow tiddlers
no
tiddlers
all the non-shadow tiddlers that exist
no
If the parameter specifies more than one category, they are processed from left to right. The overall output is initially empty, and each category's output is dominantly appended to it in turn. Unrecognised categories contribute nothing to the output.
As a special case, if the parameter is empty, the output is simply a copy of the input. This can be useful when the parameter is soft.
The is operator is similar, but its scope is restricted to its input.
Changes to the importing process to enable a smoother Upgrading process
Ignores attempts to import plugins that are older than currently installed plugins
System tiddlers are now imported as usual
If $:/theme isn't defined or refers to a missing tiddler, then fallback through Snow White to Vanilla. This means that empty.html now defaults to Snow White
Depuis : 5.1.23 You can have multiple alternative page layouts and switch between them. To see a list of available layouts and switch between them, use the keyboard shortcut ctrl-shift-L.
Creating an alternative page layout
Creating an alternative layout goes beyond adding or removing features from the default interface and allows you to create an entirely new layout from scratch.
To create an alternative page layout and have the ability to switch to it, you need to create an alternative page template tiddler with the SystemTag: $:/tags/Layout.
This alternative page template can either be a tweaked and modified version of the default page template, or something entirely different. The layout switching mechanism requires that your page template tiddler has the fields name and description, which are used in the listing in the switching user interface.
The Amazon Web Services Plugin provides several tools for working with Amazon Web Services:
Templates for saving a TiddlyWiki as a single JavaScript file in a ZIP file that can be executed as an AWS Lambda function. In this form, TiddlyWiki is a self contained single file containing both code and data, just like the standalone HTML file configuration
Commands that can be used to interact with AWS services, under both the Node.js and Lambda configurations of TiddlyWiki
In TiddlyWiki anchor links can help us link to target points and distinct sections within rendered tiddlers. They can help the reader navigate longer tiddler content.
For example this link, Bottom, should take you to the bottom of this tiddler. The "Back to the top" link below should return you back to the top of this tiddler.
Place this code at the target location. E.g. at the bottom of the tiddler.
Step 2: Create a link to the target anchor
<a href="##Bottom_of_tiddler">Bottom</a>
Create an <a href> link using exactly the same 'address' value as the target but with double ## characters preceding it.
Place this code where it will most help the reader.
The above example can be adapted to work for many situations in TiddlyWiki, such as the table of contents at the top of this tiddler.
Is it really that simple?
Yes, it's that simple. BUT... in TiddlyWiki there are some small differences from standard HTML5 anchor links and some specific TiddlyWiki limitations.
Unlike standard HTML5, in TiddlyWiki you must put a single # character in front of the target address value that follows the id attribute. (Notice the single # character used in the #Bottom_of_tiddler in Example 1.)
Unlike standard HTML5, TiddlyWiki anchor links are case sensitive. In the example above #Bottom_of_tiddler works, but #bottom_of_Tiddler wouldn't.
Avoid using the % character in your link, as some browsers have a bug where navigation to anchors containing a % character can sometimes fail (see warning below).
Avoid using any whitespace in your link (see note 1 below).
Each link address should be unique in the TiddlyWiki. If transclusions create multiple instances of the same id attribute, navigation will take place to the first instance found that satisfies the above criteria. To avoid this, you can use the qualify macro in both the id and the href attributes in a similar style to the example given below: Avoiding duplicate IDs when transcluding.
Step 2: Creating the link to the target
Remember that the href value should start with two# characters, one more than the id value of the target anchor.
Remember that TiddlyWiki anchor links are case sensitive
Step 3: Navigating to the target
Normally you can click on the link and TiddlyWiki will scroll the window so the target anchor is at the top of the window, but there are several limitations:
Anchor links in TiddlyWiki do not work if the tiddler is not in the Story River, or is not displayed in the sidebar.
Anchor links in TiddlyWiki do not work if the tidlder is in the Story River or sidebar but anchor marked target point is not visible on the page (e.g., the tiddler is folded or the anchor is within a non-displaying $reveal widget). Ctrl+Click on such an anchor link will open a new browser window/tab loading the base web page and will not navigate to the expected tiddler.
Anchor links in Tiddlywiki do not work if Control Panel > Appearance > Story View is set to Zoomin (the single page view) and the tiddler is not at the top of the story river (i.e. not displayed).
When an anchor link is clicked the browser's navigation history will be updated with the link's href value appended to the web page's URL. This will happen even if the Control Panel > Settings > Navigation History value is set to "Do not update history".
Note
1. The HTML5 specification for the id attribute says that its value should not contain any whitespace. Currently (Dec 2020) an id value with whitespace can sometimes work. However, it may not work in all browsers and is not guaranteed to work in the future.
Some browsers may fail to navigate to an anchor target whose id value includes a % character followed by 2 digits. This is a bug in the browser and nothing that TiddlyWiki can fix. To be safe, avoid using the % character.
In each case the target code is placed at the destination the reader navigates to, the link code is placed where it will help the reader navigate from.
<h2 id="#heading-01"> My Target Heading</h2>
<a href="##heading-01">Link to My Target Heading</a>
<section id="#unique001">
!! My Target section
A `<section>` HTML tag is generally used to define sections in an HTML document, such as chapters, headers, footers, or any other sections of the document.
</section>
Clicking this anchor link goes to: <a href="##unique001">Link to My Target Section</a>
This looks like:
My Target section
A <section> HTML tag is generally used to define sections in an HTML document, such as chapters, headers, footers, or any other sections of the document.
If you don't want the link to look like an external link, give the <a> element's class attribute the value tc-tiddlylink and if you want the link to also be italic & bold, give the additional classes tc-tiddlylink-missing tc-tiddlylink-shadow like below:
<a class="tc-tiddlylink" href="##Introduction:Anchor-Links-using-HTML">Back to the top</a> or just back to <a class="tc-tiddlylink tc-tiddlylink-missing tc-tiddlylink-shadow" href=<<qualify ##Hints>>>Hints</a>.
If you want to include an id attribute to a link in your sidebar Table of Contents, you can include it in your listed tiddler's caption field similar to the way shown below:
Ici quelques articles récents rédigés sur TiddlyWiki. Soumettez les nouveaux articles via GitHub, Twitter ou en postant dans les groupes de discussion TiddlyWiki.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists. The original site is missing, but a link to an archive is provided.
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
Way back in the mists of time (actually, January 2009) I wrote about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
For a new job, I decided to set up a personal wiki to keep notes. I wanted to keep it simple, meeting these requirements:
All the data is in a Dropbox folder (so it can be automatically synced between machines)
It must support Markdown syntax
After looking at the options, I settled on TiddlyWiki. I've used "classic TiddlyWiki" before, and liked its simplicity, but I was always a little annoyed with the weird steps you have to go through to save changes. The new version of TiddlyWiki includes support for running it as a real HTTP server, so you can use it just like an online wiki.
But it took me a couple of hours to figure out how to set that up. The TiddlyWiki documentation is not clear ("not clear" is a euphemistic way of saying "terrible"). So, I've written up these instructions in the hope it will spare somebody else all the frustration I had.
I'm allergic to websites that are highly dependent on JavaScript. I think that JavaScript has many useful applications to add functionality to a site, but content needs to be visible if JavaScript is switched off. I use the NoScript extension for Firefox and surf with pleasure over the Internet without spontaneous things happen that I do not give permission. I love JavaScript on a short leash. More crazier maybe I'm so excited about TiddlyWiki.
Those using multiple different computer platforms (if only PC and Android) knows for certain: You would like to sync notes across computers and thereby be independent of any apps or services. I am concerned at any rate so and so I am constantly looking for the perfect solution.
With TiddlyWiki I found it mostly. As the name suggests, it TiddlyWiki is a Wikisystem. In contrast to all other wikis, TiddlyWiki is a single HTML file that runs in the browser and thus can be used on all modern operating systems. And because there is only one file, it can be very easily via the well-known cloud services (Dropbox, Google Drive, ownCloud) or synchronized with FTP or used on a USB stick.
There is little software that can still inspire me so even after years, as on the first day. This includes TiddlyWiki, the "pocket-wiki". The latter is because the Wiki completely fits into an HTML file, and this HTML file brings everything - JavaScript program logic, CSS appearance and the entire Wiki content as stored records. So a TiddlyWiki file is then sometimes happy times some megabytes in size, but just has the unbeatable advantage that it works just as fast file created locally in a variety of browsers.
Represents an element with an attribute name of attr.
[attr="value"]
Represents an element with an attribute name of attr and whose value is exactly "value".
[attr~="value"]
Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
[attr|="value"]
Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
[attr^="value"]
Represents an element with an attribute name of attr and whose first value is prefixed by "value".
[attr$="value"]
Represents an element with an attribute name of attr and whose last value is suffixed by "value".
[attr*="value"]
Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
[attr "operator value" i]
Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Audio files can be incorporated into TiddlyWiki in a very similar way to images.
Embedded Audio
Small audio files can be embedded directly within TiddlyWiki. Embedding isn't suitable for large files (over a few hundred kilobytes) because it increases the size of the TiddlyWiki file.
For example, the tiddler TiddlyWiki.mp3 contains an MP3 recording of the word "TiddlyWiki". If you visit that tiddler, you should see an audio player that will play back the recording.
You can also transclude audio files. For example:
{{TiddlyWiki.mp3}}
Affichera ceci :
External Audio
External audio tiddlers use the _canonical_uri field to point to an external audio file/stream, and have their text field blocked. This reduces their size considerably, but still allows for playback.
S'il y a un ModuleSauvegarde qui l'accepte, TiddlyWiki déclenche automatiquement celle du document courant au clic sur valide ou sur supprime lors de la saisie d'un tiddler.
Vous apercevrez une notification jaune en haut à droite de la fenêtre confirmant qu'une sauvegarde automatique à eu lieu.
La sauvegarde automatique peut être activée ou non via l'onglet Paramétrage du panneau de contrôle . En arrière plan, elle est contrôlé par le tiddler de paramétrage $:/config/AutoSave, qui doit avoir la valeur yes pour activer la sauvegarde automatique.
Each input title is processed in turn. The corresponding tiddler's list of backlinks is generated, sorted alphabetically by title, and then dominantly appended to the operator's overall output.
All wikitext and variable substitution takes place
\function
Invoking a function in this way (<<macro>>) is a synonym for <$text text={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded
Invoked via widget attribute: <div class=<<macro>>/>
how declared
behaviour
\define
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the attribute's value
Body text is retrieved as-is and used as the attribute's value.
\function
When a function is invoked as <div class=<<macro>>/>, it is a synonym for <div class={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded. That first result is used as the attribute's value. Note that functions are recursively processed even when invoked in this form. In other words a filter expression in a function can invoke another function and the processing will continue
Invoked via filter operator parameter: [<macro>]
how declared
behaviour
\define
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the filter operator's parameter.
Body text is retrieved as-is and used as the filter operator's parameter.
\function
The body text of the function is treated as a filter expression and evaluated. The first result is passed to the operator as a parameter. The remaining results are discarded.
Invoked via function call in a filter expression: [function[macro]]
Every function is a variable, but only variables defined using \function are invokable using the function filter operator. Attempts to use a non-function variable is the same as if the function doesn't exist. The behavior in this case is like the identity function. All filter input is passed unchanged to the output.
\function
The body text of the function is treated as a filter expression and evaluated. This filter expression can itself contain a function call. Filter expressions can be factored out into functions arbitrarily deep.
Examples
Below is an example macro, procedure and function definition. All three forms of parameter substitution $a1$, <<__a1__>>, and <<a1>> are included in each definition. The output helps illustrate when each form of substitution will or will not have affect.
Every function is a variable, but only variables defined using \function are invokable using the function filter operator. Attempts to use a non-function variable is the same as if the function doesn't exist. The behavior in this case is like the identity function. All filter input is passed unchanged to the output.
\function
The body text of the function is treated as a filter expression and evaluated. This filter expression can itself contain a function call. Filter expressions can be factored out into functions arbitrarily deep.
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the filter operator's parameter.
Body text is retrieved as-is and used as the filter operator's parameter.
\function
The body text of the function is treated as a filter expression and evaluated. The first result is passed to the operator as a parameter. The remaining results are discarded.
All wikitext and variable substitution takes place
\function
Invoking a function in this way (<<macro>>) is a synonym for <$text text={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the attribute's value
Body text is retrieved as-is and used as the attribute's value.
\function
When a function is invoked as <div class=<<macro>>/>, it is a synonym for <div class={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded. That first result is used as the attribute's value. Note that functions are recursively processed even when invoked in this form. In other words a filter expression in a function can invoke another function and the processing will continue
This is a minor release prior to the full release of TiddlyWiki on September 20th. The documentation has been cleaned up and improved (with more improvements to come).
File Layout of tiddlywiki.com
The layout of files on tiddlywiki.com has been adjusted to make it more logical. See the ticket for a discussion. You can see the source files that make up tiddlywiki.com at https://github.com/Jermolene/jermolene.github.com
Hackability Improvements
Added first iteration of a list-links macro (further improvements are planned)
Added support for importing .markdown and .md files
Tout autre texte que le marqueur de début d'une des autres expressions WikiTexte en mode bloc constitue le début d'un paragraphe. Même un marqueur de début d'expression WikiTexte en mode en ligne constitue le début d'un paragraphe. L’interpréteur inclut toutes les lignes suivantes dans le paragraphe jusqu'à rencontrer une ligne vide.
Les expressions WikiTexte ci-dessus ne sont reconnues qu'en mode bloc. Par contre, le texte contenu à l'intérieur sera interprété en mode en ligne (les Citations en bloc en WikiTexte et les Styles et Classes en WikiTexte sont les deux expressions pour lesquelles l'interpréteur poursuit l'analyse en mode bloc). L'analyse en mode en ligne peut amener l'interpréteur à rencontrer un contenu qui le fait basculer en mode bloc.
À la fin de la dernière ligne du bloc, l'interpréteur retourne en mode bloc.
Note: Les fins de ligne forcées nécessitent une ligne vide supplémentaire après le """ final pour que l'interpréteur retourne en mode bloc.
Si le marqueur de début d'une des expressions de bloc ci-dessus est rencontré alors que l'interpréteur est en mode en ligne, il sera ignoré et apparaîtra tel quel dans le résultat.
Les paragraphes sont la forme la plus courante de WikiTexte. Il est important de comprendre qu'ils ne se terminent pas avant d'avoir rencontré une ligne vide. Dès qu'un paragraphe commence, l'interpréteur passe en mode en ligne. Jusqu'à ce que cette ligne vide soit rencontrée, les syntaxes de WikiTexte en mode bloc sont ignorées :
Voici un paragraphe.
Seule la syntaxe du __//mode en ligne//__ est reconnue ici.
La syntaxe du mode bloc est <b>ignorée</b> entre le début
et la fin du paragraphe (c-à-d la prochaine ligne vide).
Par exemple :
* Les listes sont ignorées
* Tout comme cette ligne horizontale<<:>>
---
|les tableaux|sont|ignorés|
! les titres sont ignorés
<<<
les citations multi-lignes sont ignorées
<<<
Affichera ceci :
Voici un paragraphe.
Seule la syntaxe du mode en ligne est reconnue ici.
La syntaxe du mode bloc est ignorée entre le début
et la fin du paragraphe (c-à-d la prochaine ligne vide).
Par exemple :
* Les listes sont ignorées
* Tout comme cette ligne horizontale :
—
|les tableaux|sont|ignorés|
! les titres sont ignorés
<<<
les citations multi-lignes sont ignorées
<<<
Pour que le WikiTexte en mode bloc soit reconnu, il faut insérer une ligne vide après la ligne « Par exemple : ». La ligne vide constituera une fin de paragraphe, et l'interpréteur commencera à reconnaître la syntaxe du mode bloc à nouveau. Comme ceci :
Voici un paragraphe.
Seule la syntaxe du __//mode en ligne//__ est reconnue ici.
La syntaxe de mode bloc est <b>ignorée</b> entre le début
et la fin du paragraphe (c-à-d la prochaine ligne vide).
Par exemple, voici une ligne vide :
* grâce à la ligne vide ci-dessus,
* les listes fonctionnent
* Tout comme cette ligne horizontale<<:>>
---
|!les tableaux|!fonctionnent|
|cellule 1| cellule 2|
! les titres fonctionnent
<<<
les citations multi-lignes fonctionnent
<<<
; Terme
: Définition de ce terme
Un autre paragraphe peut commencer ici, mais il ne finira pas avant une ligne vide.
Affichera ceci :
Voici un paragraphe.
Seule la syntaxe du mode en ligne est reconnue ici.
La syntaxe de mode bloc est ignorée entre le début
et la fin du paragraphe (c-à-d la prochaine ligne vide).
Par exemple, voici une ligne vide :
grâce à la ligne vide ci-dessus,
les listes fonctionnent
Tout comme cette ligne horizontale :
les tableaux
fonctionnent
cellule 1
cellule 2
les titres fonctionnent
les citations multi-lignes fonctionnent
Terme
Définition de ce terme
Un autre paragraphe peut commencer ici, mais il ne finira pas avant une ligne vide.
À part le paragraphe, tous les exemples de WikiTexte en mode bloc ci-dessus sont écrits une ligne après l'autre sans ligne vide intermédiaire. Ces types de WikiTexte n'ont pas besoin de ligne vide pour en marquer la fin.
Il existe deux manières de produire des éléments HTML de type citation en bloc avec TiddlyWiki, l'une pour du contenu qui pourra s'afficher sur plusieurs lignes, et l'autre pour du contenu qui ne devra s'afficher que sur une seule ligne.
Citation en bloc multi-lignes
La syntaxe pour les blocs multi-lignes est :
<<<
Ceci est un paragraphe de type citation en bloc
écrit en français
<<<
Affichera ceci :
Ceci est un paragraphe de type citation en bloc
écrit en français
Code HTML correspondant :
<blockquote class="tc-quote"><p>Ceci est un paragraphe de type citation en bloc
écrit en français
</p></blockquote>
Attribution
Une attribution peut-être ajoutée au bloc comme ceci :
<<<
Les ordinateurs sont des vélos pour nos neurones
<<< Steve Jobs
Affichera ceci :
Les ordinateurs sont des vélos pour nos neurones
Steve Jobs
Code HTML correspondant :
<blockquote class="tc-quote"><p>Les ordinateurs sont des vélos pour nos neurones
</p><cite>Steve Jobs</cite></blockquote>
Classes CSS
Les blocs peuvent hériter des propriétés de classes CSS :
<<<.myClass.another-class
Les systèmes d'exploitation sont des murs pour notre esprit
<<< Personne
Affichera ceci :
Les systèmes d'exploitation sont des murs pour notre esprit
Personne
Code HTML correspondant :
<blockquote class="tc-quote myClass another-class"><p>Les systèmes d'exploitation sont des murs pour notre esprit
</p><cite>Personne</cite></blockquote>
Le cœur de TiddlyWiki inclut la classe tc-big-quote qui représente les citations avec des guillemets géants :
<<<.tc-big-quote
Une citation dramatique
<<< Quelqu'un d'important
The BrowserStorage Plugin enables TiddlyWiki to save tiddlers in browser local storage. This means that changes are stored within the browser, and automatically re-applied any time the base wiki is reloaded.
Browser local storage is not a panacea for TiddlyWiki:
Browsers limit the amount of local storage available to a page, typically to 5 or 10MB
Keeping personal data in browser local storage can lead to unexpected privacy violations
Browsers reserve the right to without warning delete data stored in local storage at any time
Browsers tie local storage to a URL which can lead to problems if you move a wiki to a URL previously occupied by a different wiki
Please use this plugin with caution. There are a number of unresolved issues and open questions.
The BrowserStorage Plugin can be installed from the plugin library.
The browse widget displays an HTML file browser button that allows the user to choose one or more files to import. It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers imported from the files up through its parents. This message is usually handled by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.
Content and Attributes
The content of the $BrowseWidget widget is ignored.
Attribute
Description
multiple
Set to "multiple" to select multiple file upload
deserializer
Depuis : 5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension or type)
BT (née British Telecom) is the UK's largest telecommunications company. In 2007, Osmosoft was acquired by BT. JeremyRuston subsequently left BT in 2011.
En mai 2007, British Telecom a acquis Osmosoft, ma société de consultant. Acquérir une société avec un seul employé et un minuscule filet de revenu relevait d'une décision inhabituelle, Osmosoft ne détenant même pas la propriété intellectuelle de TiddlyWiki, puisque je l'avais transférée à UnaMesa pour assurer son avenir pour la communauté.
La motivation de British Telecom était de mieux comprendre les écosystèmes basés sur les communautés. Je rejoignis la société en tant que « Head of Open Source Innovation », responsable de la gouvernance open source, et fournissant des conseils et de l'expertise sur la manière de participer à des communautés open source.
The integrated actions are provided as a shortcut for invoking common actions. The same functionality is available via ActionWidgets, with the exception of the support for highlighting selected popups.
Content and Attributes
The content of the <$button> widget is displayed within the button.
Attribute
Description
to
The title of the tiddler to navigate to
message
The name of the widget message to send when the button is clicked
param
The optional parameter to the message
set
A TextReference to which a new value will be assigned
setTo
The new value to assign to the TextReference identified in the set attribute
popup
Title of a state tiddler for a popup that is toggled when the button is clicked
La « notation chameau » (en anglais « Camel Case ») est une convention de casse formée en passant en majuscule l'initiale de chaque mot d'une phrase et en supprimant les espaces entre les mots, ce qui forme un long mot composé. De nombreux wikis utilisent la Notation chameau pour marquer les phrases qui produisent automatiquement un lien.
NDT : Visuellement, l'alternance des lettres en majuscules et en minuscules dans les phrases en notation chameau produit une sorte d'ondulation, comme les bosses d'un chameau.
modify input titles by evaluating in turn a list of filters - as returned by the filter expression for this run - for each input title.
input
all titles from previous filter runs
output
the input titles as modified by the filters returned by this filter run
The filter expression for this filter run is evaluated to return a list of filters. Each input title is then evaluated against each of the filters in turn, and the input title is replaced with the first result of the first filter that returns a non-empty list. If none of the filters return a result for an input title, it is replaced with an empty string.
The following variables are available within the filter run:
currentTiddler - the input title
..currentTiddler - the value of the variable currentTiddler outside the filter run.
Cascade Filter Run PrefixFilter Run Prefix ExamplesSyntaxe d'un filtre
The :cascade filter run prefix is used by the TiddlyWiki core to choose the colour for each tiddler as used in the tag pill generated by the tag macro.
The filter expression inside the above :cascade filter run returns a list of filters from the text fields of tiddlers tagged $:/tags/TiddlerColourFilter as shown below:
[has[color]then{!!color}]
[tag[TableOfContents]then[#1e90ff]]
[tag[Working with TiddlyWiki]then[darkorchid]]
For each input title, each of these filters is now applied to in turn until the first filter that returns a non-empty list. The first result from this non-empty list replaces that input title and is used as the colour for that tiddler.
This example illustrates step-by-step how the :cascade filter run works.
A filter expression whose output returns a list of filters is required. Typically such a filter expression will construct the list of filters by querying some field in a set of tiddlers (likely via tag). To keep this example self-contained, 3 filters are stored in the filter1, filter2 and filter3 fields of this tiddler. Text references and instances of the append operator are used to combine the fields into a list of filters.
The filter [{!!filter1}append{!!filter2}append{!!filter3}], generates this list of filters:
[prefix[ca]then[ca]]
[suffix[at]then[at]]
other
For this example, cat can bat bug will be used as the input titles. Each input title will be evaluated by :cascade against each of the above filters in turn. To help understand what :cascade sees internally, the following table uses the Map Filter Run Prefix to show the result of each individual filter.
cat can bat bug :map[prefix[ca]then[ca]]
cat can bat bug :map[suffix[at]then[at]]
cat can bat bug :map[[other]]
Click "Try it" on the above 3 examples. The first non-blank value from each row as read from left to right will be returned when :cascade is used. Click "Try it" below to see the final result:
cat can bat bug :cascade[{!!filter1}append{!!filter2}append{!!filter3}]
Cascades provide a means to select one of multiple values based on flexible, extensible criteria. They can be thought of as a list of conditions that are evaluated in turn until one of them matches.
Each cascade is defined by a special tag which identifies the tiddlers containing the conditions to be matched. The Order of Tagged Tiddlers determines the order in which the conditions are processed, and provides the means for arranging new rules at specific points in the cascade.
The conditions are defined by a Filter Expression in the text field. The filters are evaluated with the list of input titles set to the title of the tiddler to be considered. The currentTiddler variable is also set to the title of the tiddler to be considered.
If the filter returns no result then that result will be ignored and the cascade proceeds to test the next condition. If the filter expression does return at least one result then it serves as the result of the entire cascade.
The Story Tiddler Template Cascade contains the logic for determining a tiddler should be displayed as an editable draft or in view mode. By default, it consists of two tiddlers containing the following list of rules:
[is[draft]then{$:/config/ui/EditTemplate}] – if it is a draft tiddler, use the template title given in the tiddler $:/config/ui/EditTemplate
[{$:/config/ui/ViewTemplate}] – otherwise, use the template title given in the tiddler $:/config/ui/ViewTemplate
Usage in the core
The TiddlyWiki core uses cascades to choose the following elements:
The template used to display a particular tiddler in the story river. By default, the edit template is chosen for draft tiddlers, and the view template for others
The optional colour associated with a particular tiddler (used to colour the tiddler icon and if the tiddler is used as a tag also provides the colour for the tag pill)
Cette version résoud un certain nombre d'incohérences dans la manière dont les filtres sont gérés. Ces changements impliquent que les filtres préexistants peuvent nécessiter des mises à jour — en particulier ceux qui s'exercent potentiellement sur des tiddlers manquants ou shadow.
Changements à is et ajout de all
La plupart des opérateurs de filtres agissent en réagençant tout ou partie des titres source. Ceux qui ajoutent de nouvelles entrées qui ne faisaient pas partie de la liste sur laquelle ils agissent sont nommés sélecteurs. Avant la version 5.0.9-beta, quelques nouveaux opérateurs de filtres étaient incohérents dans leur manière de filtrer la liste source ou d'y ajouter de nouvelles entrées.
Les changements spécifiques sont les suivants :
L'opérateur is se contente à présent de filtrer à partir de la liste de tiddlers déjà sélectionnée
Le nouvel opérateur all agit comme sélecteur en remplaçant la liste en cours avec une combinaison de tidddlers issus des sources spécifiques suivantes :
current pour le tiddler courant
missing pour tous les tiddlers manquants
orphans pour tous les tiddlers orphelins
shadows pour tous les tiddlers shadow
tiddlers pour tous les tidders non-shadow (comprenant à la fois les tiddlers système et non système)
Les sources de l'opérateur all peuvent être combinées à l'aide du caractère +. Par exemple, [all[shadows+tiddlers]] renvoie tous les tidders shadow ainsi que tous les tiddlers ordinaires.
Précédemment, il n'était pas rare d'avoir [is[shadow]] au début d'une chaîne de filtre pour sélectionner tous les tidders shadow. À partir de 5.0.9, au lieu de renvoyer tous les tiddlers shadow, cela renverra seulement les tiddlers ordinaires qui s'avèrent être aussi un tiddler shadow (par la grâce d'en avoir écrasé un). La solution consiste à utiliser le nouvel opérateur all. Par exemple, si l'on considère ce filtre tiré de 5.0.8 :
On remarque comment l'opérateur all permet d'effectuer des opérations sur des tiddlers à partir de combinaisons de sources.
Changements pour [is[current]]
Une conséquence de ces changements est que [is[current]] est à présent un pur filtre sur les tiddlers source ; du coup, si le tiddler courant est un tiddler manquant qui ne se trouve pas dans la liste source, [is[current]] renverra une liste vide.
Généralement, la solution consiste plutôt à utiliser [all[current]]. Ce n'est pas aussi naturel à lire, mais ça a le comportement attendu de retourner systématiquement le tiddler courant, qu'il se trouve ou non parmi les tiddlers sources.
Changements concernant title et field
Il y a des changements mineurs sur la façon dont fonctionnent les opérateurs title et field.
L'opérateur title est un sélecteur : il renvoie le titre spécifié, qu'il se trouve ou non dans la source courante. title est utilisé comme opérateur par défaut si aucun opérateur n'est spécifié.
L'opérateur field est un filtre : il se contente de retourner un sous-ensemble des tiddlers source. field est utilisé comme opérateur par défaut si l'opérateur fourni n'est pas défini (l'opérateur fourni est alors passé comme suffixe de l'opérateur field, de sorte que [description[Missing]] est équivalent à [field:description[Missing]]).
This operator returns a string formed from concatenating the characters specified by the numeric codes given in one or more operands. It is useful for generating special characters such as tab (charcode[9]) or new line (charcode[13],[10]).
The checkbox widget displays an HTML <input type="checkbox"> element that is dynamically bound to either:
the presence or absence of a specified tag on a specified tiddler
the value of a specified field of a specified tiddler
Content and Attributes
The content of the <$checkbox> widget is displayed within an HTML <label> element immediately after the checkbox itself. This means that clicking on the content will toggle the checkbox.
Attribute
Description
tiddler
Title of the tiddler to manipulate (defaults to the Current Tiddler)
The name of the tag to which the checkbox is bound
invertTag
When set to yes, flips the tag binding logic so that the absence of the tag causes the checkbox to be checked
The name of the field to which the checkbox is bound
Depuis : 5.2.3 The name of the field that contains the list to which the checkbox is bound
Depuis : 5.1.14 The property of the DataTiddler to which the checkbox is bound
Depuis : 5.2.3 Like index, but treats the value as a list the same way that listField does
Depuis : 5.2.3 A filter whose output determines the checked state of the checkbox
checked
The value of the field corresponding to the checkbox being checked
unchecked
The value of the field corresponding to the checkbox being unchecked
default
The default value to use if the field is not defined
Whether ambiguous values can produce indeterminate checkboxes (see below)
class
The class that will be assigned to the <label> element
Depuis : 5.2.3tc-checkbox is always applied by default, as well as tc-checkbox-checked when checked
actions
Depuis : 5.1.14 A string containing ActionWidgets to be triggered when the status of the checkbox changes (whether it is checked or unchecked)
uncheckactions
Depuis : 5.1.16 A string containing ActionWidgets to be triggered when the checkbox is unchecked
checkactions
Depuis : 5.1.20 A string containing ActionWidgets to be triggered when the checkbox is checked
disabled
Depuis : 5.1.23 Optionally disables the checkbox if set to yes (defaults to no)
Using the checkbox widget in field mode requires the field attribute to specify the name of the field. The checked and unchecked attributes specify the values to be assigned to the field to correspond to its checked and unchecked states respectively. The default attribute is used as a fallback value if the field is missing or contains a value that does not correspond to the value of the checked or unchecked attributes.
This example creates a checkbox that is checked if the field status is equal to open and unchecked if the field is equal to closed. If the field value is undefined then it defaults to closed.
<$checkbox field="status" checked="open" unchecked="closed" default="closed"> Is it open?</$checkbox>
''status:'' {{!!status}}
Using the checkbox widget in filter mode requires the filter attribute to contain a filter whose output will determine the checked state of the checkbox. In filter mode, checking the checkbox will not automatically make changes to any field of any tiddler. Instead, you can use the actions attribute (or the checkactions and uncheckactions attributes) to specify what should happen when the checkbox is toggled. It is your responsibility to make sure the actions cause changes to the tiddlers or fields that the filter results depend on, so that the checkbox becomes properly checked or unchecked after the actions have triggered and the filter has updated.
If the filter returns an empty result, the checkbox will be unchecked. Otherwise, if the filter result is non-empty, the checkbox will be checked.
However, if either the checked or unchecked attributes (or both) are specified, then their values will be looked for in the filter result, instead of considering any non-empty value to mean checked.
This example creates the same checkbox as in the , selecting between red and green in the colors list field, but using filters and actions to make the change.
If both the checked and unchecked attributes are specified, but neither one is found in the specified field (or index), the result can be ambiguous. Should the checkbox be checked or unchecked? Normally in such cases the checkbox will be unchecked, but if the indeterminate attribute is set to yes (default is no), the checkbox will instead be in an "indeterminate" state. An indeterminate checkbox counts as false for most purposes — if you click it, the checkbox will become checked and the checkactions, if any, will be triggered — but indeterminate checkboxes are displayed differently in the browser.
This example shows indeterminate checkboxes being used for categories in a shopping list (which could also be sub-tasks in a todo list, or many other things). If only some items in a category are selected, the category checkbox is indeterminate. You can click on the category checkboxes to see how indeterminate states are treated the same as the unchecked state, and clicking the box checks it and applies its check actions (in this case, checking all the boxes in that category). Try editing the fruits and vegetables fields on this tiddler and see what happens to the example when you do.
To use the checkbox widget in index mode set the index attribute to a property of a DataTiddler. The checked and unchecked attributes specify the values to be assigned to the property and correspond to its checked and unchecked states respectively. The default attribute is used as a fallback value if the property is undefined.
Make sure to set tiddler correctly, because non-DataTiddlers will be overwritten without warning
The example below creates a checkbox that is checked if the property in the tiddler ExampleData by the name of the current tiddler is equal to selected and unchecked if the property is an empty string. If the property is undefined then it defaults to an empty string, meaning the checkbox will be unchecked if the property is missing.
Using the checkbox widget in list mode requires the listField attribute to specify the name of a field containing a list. The checked attribute specifies the value that should be present or absent in the list when the checkbox is checked or unchecked respectively. If checked is absent (or empty) but unchecked is present, then the logic will be inverted: the checkbox will be checked when the unchecked value is missing from the list, and unchecked when the unchecked value is found in the list. If both checked and unchecked are present, the checkbox will work like a toggle, replacing the checked value with the unchecked value and vice-versa. Finally, if neither checked nor unchecked is specified, the checkbox will be checked if the field has anything in it, but unchecked if the field is missing or empty. (This is rarely useful. Most of the time you want to specify checked or unchecked or both.)
The default attribute is used as a fallback for the checkbox state if the field is not defined.
The following table summarizes the possible combinations:
defined attributes
neither
field missing or list empty no default defined
field has any value
–
checked=item1
item1 removed from list
item1 added to list
–
unchecked=item2
item2 added to list
item2 removed from list
–
both
item1 removed from list item2 added to list
item1 added to list item2 removed from list
item1 not in list item2 not in list no default defined
This example creates a checkbox that is checked if the list field named colors contains green and unchecked if the field contains red. If the field is undefined, or if neither green nor red appears in the field, then it defaults to green, meaning that the checkbox will be checked.
<$checkbox listField="colors" checked="green" unchecked="red" default="green"> Is "green" in colors?</$checkbox><br />''colors:'' {{!!colors}}
Affichera ceci :
colors:
Try editing the colors field of this tiddler to see how the example changes.
Using the checkbox widget in index list mode requires the listIndex attribute to specify the the property of a DataTiddler. This property contains a list. The checked attribute specifies the value that should be present or absent in the list when the checkbox is checked or unchecked respectively. If checked is absent (or empty) but unchecked is present, then the logic will be inverted: the checkbox will be checked when the unchecked value is missing from the list, and unchecked when the unchecked value is found in the list. If both checked and unchecked are present, the checkbox will work like a toggle, replacing the checked value with the unchecked value and vice-versa. Finally, if neither checked nor unchecked is specified, the checkbox will be checked if the field has anything in it, but unchecked if the field is missing or empty. (This is rarely useful. Most of the time you want to specify checked or unchecked or both.)
The default attribute is used as a fallback for the checkbox state if the property is undefined.
The following table summarizes the possible combinations:
defined attributes
neither
property missing or list empty no default defined
property has any value
–
checked=item1
item1 removed from list
item1 added to list
–
unchecked=item2
item2 added to list
item2 removed from list
–
both
item1 removed from list item2 added to list
item1 added to list item2 removed from list
item1 not in list item2 not in list no default defined
Make sure to set tiddler correctly, because non-DataTiddlers will be overwritten without warning
The example below creates three checkboxes that each control a different value in a property of the ExampleData tiddler.
<$set name=indexName filter="[<currentTiddler>addsuffix[ Colors]]" >
<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="green" unchecked="red" default="red"> Green or red?</$checkbox><br/>
<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="yellow" unchecked="blue" default="blue"> Yellow or blue?</$checkbox><br/>
<$checkbox tiddler="ExampleData" listIndex=<<indexName>> checked="orange" unchecked="purple" default="purple"> Orange or purple?</$checkbox><br/>
Colors list: <$text text={{{ [[ExampleData]getindex<indexName>] }}} />
</$set>
Using the checkbox widget in tag mode requires the tag attribute to specify the name of the tag. The checkbox will be checked if the tiddler specified in the tiddler attribute has the specified tag and unchecked if it does not.
This example creates a checkbox that flips the done tag on the current tiddler:
<$checkbox tag="done"> Is it done?</$checkbox>
Affichera ceci :
When the attribute invertTag is set to yes, the checkbox will be checked if the tiddler does not have the specified tag and unchecked if it does.
<$checkbox tag="done" invertTag="yes"> Is it not done?</$checkbox>
Un bloc de code () est délimité par trois caractères « accent grave » ``` (connus en anglais sous le nom de « backticks ») :
```
Ce texte aura une chasse fixe et ne sera pas `formaté`.
```
Donnera le résultat suivant :
Ce texte aura une chasse fixe et ne sera pas `formaté`.
Pour être interprétés correctement, les trois accents graves doivent être placés au début d'une ligne et immédiatement suivis d'un retour à la ligne.
Souvenez-vous que le paragraphe précédent doit s'être terminé correctement, à l'aide de deux retours à la ligne. L'exemple suivant est donc faux :
Ceci est un paragraphe ordinaire.
```
Ce texte aura une chasse fixe et ne sera pas `formaté`.
```
La version correcte est :
Ceci est un paragraphe ordinaire.
```
Ce texte aura une chasse fixe et ne sera pas `formaté`.
```
Certains claviers traitent l'accent grave comme une touche morte, le rendant difficile à saisir tout seul. L'astuce consiste à saisir 3 ` suivis d'un espace. Une autre méthode consiste à saisir 6 ` d'affilée, puis de bouger le curseur en arrière trois fois pour saisir ou coller le contenu du bloc.
The codeblock widget renders text in <pre> and <code> blocks, causing it to be
displayed monospace. A language may optionally be specified using the
language attribute, however syntax highlighting will only be used if the
Highlight Plugin is installed.
Content and Attributes
The content of the <$codeblock> widget is ignored.
The colour (or color) macro returns the CSS value of one the colours in the current palette.
If no such entry exists in the current palette, the vanilla palette is used instead. If no such entry exists in the vanilla palette, the system looks for a configuration tiddler with the title $:/config/DefaultColourMappings/<colour-name> and transcludes the colour from the text field. This enables to plugins to ship defaults for colours that are not present in the core palettes.
Parameters
name
The name of the palette entry, e.g. page-background
The colour-picker macro displays an interactive colour picker, as can be seen in the core bitmap editor.
Parameters
actions
Wikitext for the action widgets that should be executed when the user selects a colour. Within the text, the variable colour-picker-value contains the selected colour.
Une palette de couleur est un tiddler data qui affecte une valeur de couleur CSS, comme yellow ou #fe0, à chacun des multiples noms de couleur, de cette façon :
page-background: #fe0
table-border: #ccc
...
Plusieurs palettes font partie du noyau. le tiddler système $:/palette contient toujours le titre du tiddler en cours de la palette sélectionnée.
Pour récupérer la valeur du nom d'une couleur dans la palette courante, ex : à employer dans un tiddler stylesheet, faites appel à la macro colour :
<<colour page-background>>
Les tiddlers palette tiddlers contiennent les champs suivants :
Le CSV est un format de texte brut standard pour stocker des tableaux de données.
Chaque ligne d'une table est appelé un enregistrement (record) et n'occupe qu'une seule ligne.
Les colonnes sont appelées champs (field). Chaque champ d'une ligne est séparée du suivant par une virgule, et souvent encadré par des balises double-cote.
La macro csvtiddlers renvoie le contenu d'un tiddler dans ce format.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists. The original site is missing, but a link to an archive is provided.
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
This instruction is based on Tiddlywiki single html file model, while it can use subfolder for extra materials like images, audios, videos, pdfs,... in separate folders.
This instruction is based on local edit, save and push to GitHub. It does NOT use the new GitHub Saver mechanism (requires TW 5.1.20+) which lets edit and save directly from Tiddlywiki!
TiddlyWiki for Scholars est une personnalisation de TiddlyWiki 5.0.13-beta, que j'ai écrite en pensant à la prise de notes à partir de lectures, mais qui peut servir à d'autres choses. L'idée est de montrer et de faciliter la création des données liées au tiddler courant sans quitter le tiddler.
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
This tutorial is aimed at giving you a basic foundation so that you can start using TiddlyWiki right away. Here we take a look at the technology behind Tiddlywiki, how to install it and create your first Tiddler.
These are prepackaged editions created by the TiddlyWiki Community. These are TiddlyWikis with added plugins and configurations to facilitate a certain use-case. These are great starting points if you want to quickly jump into TiddlyWiki and start using it without spending too much time configuring yourself.
Drift is an adaptation of TiddlyWiki with the goal of helping you Collect. Organise. and Grow. your ideas while keeping tab on how they interconnect together and fluidly Drift from one to another.
The 2 main components of Drift are TWCrosslinks and DailyNotes so you never miss an idea
Drift was inspired by TiddlyBlink / Stroll and adapted to fit my needs.
NoteSelf est votre version personnelle, privée, et personnalisable de l'expérience utilisateur d'Evernote.
Vous voulez du cloud ? Bien ! Vous n'en voulez pas ? C'est bien aussi ! C'est à vous, c'est votre choix !
Pourquoi ne seriez-vous pas un peu égoïste ?
NoteSelf est le support parfait pour vos idées, vos notes, vos pensées, vos astuces, vos recettes... tout ce que vous voulez !
NoteSelf les stockera, les indexera et les rendra faciles à rechercher, pour que vous les trouviez instantanément quand vous en avez besoin !
Vous connaissez déjà Evernote et vous l'adorez, nous le savons bien. Il est confortable, il se synchronise, il permet la recherche...
Ouah ! Il est presque parfait, mais que pensez-vous de :
La vie privée : tout est stocké sur les serveurs d'Evernote !
La personnalisation : si vous n'aimez pas l'interface d'Evernote, il n'y a rien à faire.
NoteSelf est construit sur la base de TiddlyWiki, un logiciel libre de wiki personnel puissant, gratuit et hautement personnalisable.
Nous en avons tiré le meilleur, son système puissant de personnalisation, et l'avons combiné avec une des meilleures
bases de données embarquées disponibles, PouchDb, pour y apporter les capacités de synchronisation dont vous avez besoin.
Cardo is a standalone, browser-based tool that can be used as a simple task manager, or as a complex Project Management system (and indeed, I do use it this way in my daily work) as well as a fully Wiki-ized personal knowledge store. It runs completely independently in the browser, even without an Internet connection, making it possible to carry around on a USB stick, or to use on the morning commute.
Stroll is a TiddlyWiki adaptation imitating certain features of Roam to help users easily see connections between their notes and navigate between them. Features include:
L'Agrégateur de liens communautaire est une collection fréquemment mise à jour de liens vers des ressources utiles et intéressantes sur TiddlyWiki, dénichées par notre équipe d'éditeurs communautaires. Le site agrège les liens soigneusement sélectionnés par les membres de la communauté TiddlyWiki. Il permet de visualiser les liens les plus récents, et de les explorer par catégorie et chronologiquement.
Plus les contributeurs sont nombreux, et mieux le site fonctionne ! Comme chacun n'est pas tenu de recenser chaque lien qui passe, la pression individuelle sur les contributeurs est réduite. L'agrégation des liens réduit aussi l'impact d'une erreur, par exemple d'une erreur de catégorisation : si un contributeur catégorise un lien dans la mauvaise rubrique, le site permet de voir qu'une seule personne a utilisé cette rubrique, alors que la majorité utilise la catégorie appropriée. Ainsi, nous espérons qu'une sorte d'intelligence collective émergera, avec un consensus sur la manière la plus utile de décrire et de catégoriser les liens.
This is a list of palettes made by members of the TiddlyWiki Community. Palettes change the colourscheme of TiddlyWiki and can be used in combination with themes.
These are plugins created by the TiddlyWiki Community. Visit their website to try out the plugin. Carefully read the installing instructions and back up before installing! These plugins may not always be up to date and can contain bugs or unwanted behaviour. For even more plugins, visit the TiddlyWiki Groups. New plugins get posted and announced there first.
TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
Create concept maps and quickly manifest your ideas in tiddlers.
Create task-dependency graphs to organise and describe your tasks.
Visualise your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualise and describe any network-structure you have in mind.
vis.js Timeline is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable timelines. This project is a direct continuation of emkay's plugin.
This is a Control Panel extension that aims to simplify the plugin creation and editing process. After installing, you will find a new tab in your control panel that makes creating and modifying plugins a little bit easier.
The ThirdFlow plugin brings to you another way to develop customisation plugins for TiddlyWiki 5. It is not enforcing a specific development flow, it simply tries to help you. Otherwise, it tries to stay out of your way.
The FontAwesome plugin supports embedding Font Awesome in TiddlyWiki 5. There is no need to install this font into your operating system in order to use it with TiddlyWiki 5. The font is already embedded in this TiddlyWiki 5 customisation plugin instead, so nothing else to install.
An experimental MathJax plugin for TiddlyWiki version 5. As Martin says, the implementation is a bit of a hack but may be useful until we have a better alternative.
Welcome. I have created plugin for TiddlyWiki 5 which allows you to use MathJax (math in TeX and MathML) inside TiddlyWiki 5. It's unofficial plugin and it doesn't follow general policy of TiddlyWiki as stand-alone solution but it works. So you can use it if you want.
For those who use many tags or store many different topics in a common wiki the Locator plugin is a table of contents widget and an enhanced search engine that gives you the opportunity to filter results by related tags. Unlike table of contents, standard search and list of tags, this plugin offers these features in an organic, collaborative way.
The leaflet plugin is a (working) attempt to integrate the leaflet library in TiddlyWiki in order to display geographical purpose tiddlers.
For now <$leafmap> widget displays an interactive map. Select size, location and zoom, clustering distance, and background. You can display data : geojson, point(s), polygon(s) and/or polyline(s) directly or calling GeoTiddler(s). Tiddler can be called individually, by list or with a filter.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
Provides an alternative search result list that orders results by search relevance and ignores differences in word forms (ex. tag vs tags).
On my personal wiki, I have the problem that there are terms I use across a lot of tiddlers, and sometimes I'll use different forms (such as the aforementioned tag vs tags). I wanted a plugin to allow me to find the tiddler I'm looking for quickly and didn't require me to worry about how I declined a noun or inflected a verb - so I wrote this plugin, which provides an alternative search list powered by lunr.js.
Use this plugin to give your visitors the opportunity to comment on your tiddlers without changing the wiki itself.
Disqus is a networked community platform used by hundreds of thousands of sites all over the web. With Disqus, your website gains a feature-rich comment system complete with social network integration, advanced administration and moderation options, and other extensive community functions.
datepicker is a TiddlyWiki plugin that allows you to use a widget much like EditTextWidget to pick a date, and optionaly a time. It shows a nice interactive mini-calendar when clicked, allows you to set a date format for display, and is compatible with core date fields such as modified and created.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
Only Firefox and Safari support MathML at the moment, so the plugin is only useful if you're using one of these browsers. It might be possible to combine this plugin with MathJax to convert MathML to something that other browsers can understand, e.g. HTML+CSS, but I haven't tried this.
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10).
Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5.
To share my knowledge, I made a few guides about these 'modifications'.
The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
...is a tool to save and reload sets of Tiddlers. This is already working, The aim is to develop a mechanism to transform these into instant slideshows.
MetaTabs
is a tool which gives you the possibility to attach and show specific information in tabs at the bottom of each Tiddler: ideas, notes, tasks, stories and presentations, comments, annotations and footnotes.
It is inspired by MagicTabs and Tiddlyscholar by Alberto Molina Pérez, which are very elaborated tools that alas do not seem to be in active development any more.
I wanted to change the behaviour in some ways. For example I wanted show tabs only if they have content.
...furthermore there is
an export-plugin,
a footnote-plugin,
and a plugin to rearrange Tiddlers in the StoryRiver
In keeping with the general spirit of the TiddlyWiki community, ie, you develop something useful and/or potentially interesting you share it with others, I'm sharing some of the plugins I've developed to go with the new Editor Toolbar. You'll find them and a more extensive discussion of what each does at http://skplugins.tiddlyspot.com/
The javascript code is based on the built-in module $:/core/modules/commands/load.js that loads tiddlers from a Tiddlywiki file into a node.js Tiddlywiki instance. This command loads all non-system tiddlers, irrespective of whether they have been modified since last loaded. As a result, all tiddlers in the node.js tiddlers folder will end up with a new modification date.
In contrast, the loadnew command only loads tiddlers that either don't already exist in the tiddlers folder, or have a newer modified date than the existing tiddler.
With a backup strategy that uses a file system snapshot process to preserve historical versions of tiddlers, the loadnew command minimises the sizes of the resulting snapshots.
Refnotes plugin is a set of macros and stylesheets for creating abbreviations, footnotes and citations. It also makes tables of footnotes, abbreviations (glossary) and references (bibliography table).
The content or description and data of events are stored in individual tiddlers.
Timelines contain two timeline macros and two sequence macros. A sequence macro shows event contents in sequence not necessarily in chronological order. The order can be determined by tag or list field or other methods.
The plugin library introduces a very simple mechanism like Tiddlywiki Official Plugin Library to let select among the published plugins and install any number of them you like.
A favorite item also called a bookmark is a shortcut, you are creating for quick access to it. You can access that bookmark at any time and view that as many times as you want without having to search and find it again.
The Favorites plugin contains three modes
flat mode: one favorite list, no folder
structured mode: use folder, search tool, export and delete tool
frozen list: read only, simple table of content style
The trash (also known as the Recycle Bin in Microsoft Windows) is a temporary storage for tiddlers that have been deleted in a Tiddlywiki by the user, but not yet permanently erased.
Typically, a trash bin is presented as a special storage, allowing the user to browse deleted (removed) tiddlers, undelete those that were deleted by mistake, or delete them permanently (either one by one, or by the "Empty Trash" function).
With Todolist, easily organise and prioritise your tasks and projects so you’ll always know exactly what to work on next.
Todolist creates custom UI and lets you to add new items, set priority, done/undone items, archive, delete. Using Todolist plugin it is possible to create several todo lists in one Tiddlywiki.
Title operation: add, remove prefixes and suffixes, also remove cahras form begining and end of title (on renaming tiddlers, relink can be used to update title in other tiddlers)
Tag operation: add, remove, replace
Field operation: add, remove, rename, and set field value
SnR, search and replace in all fields including text, tags, title, and common fields
Inspect, to review and inspect tiddlers in one place, scroll among them and edit all fields (including common fields), tags, text (title is an exception!)
Log, create logs of all operations
Search, save and load any combination of filter search
This is a list of themes made by members of the TiddlyWiki Community. Themes change the look and feel of TiddlyWiki, allowing for another degree of customisation. Installing themes works the same as plugins.
Notebook is a clean, uncluttered theme for TiddlyWiki.
The theme is responsive and comes with mobile support through the included notebook-mobile plugin.
Notebook comes with 3 default colour palettes, a grey, beige and dark one. To switch between colour palettes, click the color palette switch button in the top bar.
Notebook uses a custom left sidebar, with another sticky bar at the top of the page (or at the bottom on mobile).
Moments is a beautiful free and responsive theme available for wordpress from here: http://www.s5themes.com/theme/moments/. This is an adaptation of the same for TW5 platform. All the design credits goes to the site and the original designer. If TW5 is going to be here for 25 years, might as well suit up.
Note that several of the variants of the compare operator are synonyms for existing operators, and are provided in the interests of consistency. For example, compare:string:eq[x] is a synonym for match[x].
It's a frequent use case in TiddlyWiki that you will want to put the results of variables together with various bits of strings of text. This process in some programming languages is often referred to as "concatenating" text.
You might, for instance want to set up a template for your customer database, where links will automatically refer to additional contact information about your customer. Inside your tiddler, you might try something like this:
⚠ Attention : Ne faites pas comme ça !
[[Additional Info|<<currentTiddler>>-Contact]]
But that won't work. If you try this, the link will be interpreted very literally, and will attempt to take you to:
<<currentTiddler>>-Contact
The solution is to use a macro to put the rendered value of <<currentTiddler>> together with the bit of additional text, -Contact.
Create a macro at the top of the tiddler like this:
In this case, we passed the value of a variable directly to our macro. This is often a general way to go about this task. If you wanted to create more links based on other variables you could re-use the macro for each situation.
If, as in this case, the only variable you are using is currentTiddler then you could write a simple macro, like this:
Notice that in this case we don't pass an argument. Instead, we reference the variable using the special syntax $(variable)$. Since we don't pass an argument, we can invoke it without the <$macrocall> widget more simply, like this:
Depuis : 5.1.20The conditional filter operators allow for if-then-else logic to be expressed within filters.
The foundation is the convention that an empty list can be used to represent the Boolean value false and a list with at one (or more) entries to represent true.
The conditional operators are:
then Operator replaces any input values with a constant string. For example:
else Operator if the title list is empty then returns a constant string, otherwise returns the original title list
These operators can be combined. For example:
[[New Tiddler]is[missing]then[I am missing]else[No I am not missing]]
The else operator can be used to apply a defaults for missing values. In this example, we take advantage of the fact that the get operator returns an empty list if the field or tiddler does not exist:
You can configure TiddlyWiki to start up using whatever individual or group of tiddlers you want using the default tiddlers mechanism.
In the control panel under the info tab is an input field labeled "Choose which tiddlers are displayed at startup". You can list whatever tiddlers you want to open at startup. Use double square brackets for titles containing spaces. For example:
FirstTiddler
SecondTiddler
[[Third Tiddler]]
You can also use filter expressions to open more than one tiddler. For example:
The Consent Banner Plugin helps make websites that are compliant with "cookie legislation" such as the EU General Data Protection Regulation.
It presents a banner inviting the user to accept or reject cookies, keeping track of their consent in local storage so that the banner can be hidden on subsequent visits.
By default, content embedded with <iframe>, <embed> and <object> is blocked unless the user consents to accept cookies.
Consent status is available via a configuration tiddler so that it is possible to construct content that behaves differently depending upon whether consent has been granted. As an example, a macro is provided for embedding YouTube videos that automatically uses the youtube-nocookie.com variant of video URLs unless the user has accepted cookies.
Please note that using this plugin does not guarantee compliance with any particular legislation. You will need to understand the technical issues specific to your situation, and if necessary seek legal advice.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
À l'instar d'autres projets OpenSource, TiddlyWiki5 a besoin que ses contributeurs signent un accord de licence pour leurs contributions. C'est un accord contractuel qui permet aux contributeurs de confirmer qu'ils sont propriétaires des droits d'auteur de leurs contributions, et qu'ils acceptent de les licencier à l'Association UnaMesa (l'entité juridique qui possède TiddlyWiki au nom de la communauté).
Proposez une contribution (PullRequest) sur GitHub en ajoutant à cla-individual.md ou cla-entity.md, votre nom suivi de la date au format (YYYY/MM/DD).
Dans le document cla-individual.md ou le cla-entity.md cliquez sur l'icone dans le coin en haut à droite, ce qui créera une copie modifiable du projet, un fork, dans votre espace de propositions et vous permettra de modifier ses différents documents
Modifiez la licence en ajoutant votre nom en bas comme dans l'exemple, eg : Jeremy Ruston, @Jermolene, 2011/11/22
Les documents de CLA utilisés pour ce projets ont été créés en utilisant les modèles du projet Harmony. "HA-CLA-I-LIST Version 1.0" pour la "CLA-individuelle" et "HA-CLA-E-LIST Version 1.0" pour la "CLA-organisation".
Remarque
Au cas où vous ne soyez pas propriétaire des droits d'auteurs de toutes vos propositions !
Veuillez le mentionner clairement, ou nous vous considérerons comme le détenteur légal des droits d'auteur de la contribution ! Aussi, veuillez fournir les liens et informations additionnelles décrivant sous quelle licence le reste du code est diffusé.
À l'instar d'autres projets OpenSource, TiddlyWiki5 a besoin que ses contributeurs signent un accord de licence pour leurs contributions. C'est un accord contractuel qui permet aux contributeurs de confirmer qu'ils sont propriétaires des droits d'auteur de leurs contributions, et qu'ils acceptent de les licencier à l'Association UnaMesa (l'entité juridique qui possède TiddlyWiki au nom de la communauté).
Proposez une contribution (PullRequest) sur GitHub en ajoutant à cla-individual.md ou cla-entity.md, votre nom suivi de la date au format (YYYY/MM/DD).
Dans le document cla-individual.md ou le cla-entity.md cliquez sur l'icone dans le coin en haut à droite, ce qui créera une copie modifiable du projet, un fork, dans votre espace de propositions et vous permettra de modifier ses différents documents
Modifiez la licence en ajoutant votre nom en bas comme dans l'exemple, eg : Jeremy Ruston, @Jermolene, 2011/11/22
Les documents de CLA utilisés pour ce projets ont été créés en utilisant les modèles du projet Harmony. "HA-CLA-I-LIST Version 1.0" pour la "CLA-individuelle" et "HA-CLA-E-LIST Version 1.0" pour la "CLA-organisation".
Remarque
Au cas où vous ne soyez pas propriétaire des droits d'auteurs de toutes vos propositions !
Veuillez le mentionner clairement, ou nous vous considérerons comme le détenteur légal des droits d'auteur de la contribution ! Aussi, veuillez fournir les liens et informations additionnelles décrivant sous quelle licence le reste du code est diffusé.
This file was automatically generated by TiddlyWiki5
Like other OpenSource projects, TiddlyWiki5 needs a signed contributor license agreement from individual contributors. This is a legal agreement that allows contributors to assert that they own the copyright of their contribution, and that they agree to license it to the UnaMesa Association (the legal entity that owns TiddlyWiki on behalf of the community).
Depuis : 5.2.4 We introduced absolute coordinates that may not work with all extensions and plugins. For maximum backwards compatibility, use absolute coordinates only where necessary.
Relative coordinate system
The default coordinate system is relative to the nearest positioned ancestor element. This is either:
an element with a non-static position, or
a td, th, table in case the element itself is static positioned.
For tiddlers the nearest positioned ancestor element mostly is the body of the tiddler. Read the next chapter to learn about the exceptions.
Relative coordinates are expressed in the form (x,y,w,h). Where x and y represent the position and w and h the width and height of the element.
Absolute coordinate system
The relative coordinate system works flawless most of the time. Problems occure if the target element (for example, a popup) and the source element (the triggering button) do not share the same positioned ancestor element. This is often the case if the popup is declared outside a table and the triggering button is declared within a table cell. In this case the coordinate systems have different origins and the popup will be displayed in the wrong location.
Absolute coordinates can fix this problem by using the root element of the page (the upper-left corner of the page) as the origin of the coordinate system. Absolute coordinates are expressed in the form @(x,y,w,h). Where x and y represent the position and w and h the width and height of the element. The leading @-symbol marks these coordinates as absolute.
The ButtonWidget has an option (popupAbsCoords) to put absolute coordinates into the state tiddler. The DraggableWidget and the EventCatcherWidget provide the absolute coordinate of an event within the attribute tv-popup-abs-coords.
Example
The following example shows a popup that is triggered from within a table cell. The table cell is the nearest positioned ancestor element. The popup was defined outside the table cell. The button using relative coordinates will open the popup in the wrong location because the button and the popup do not agree on the same coordinate system. Using absolute coordinates fixes this problem.
The copy-to-clipboard macro displays a button that copies specified text to the clipboard. A notification is displayed if the operation is successful; some browsers do not permit the operation.
Parameters
src
The text to be copied to the clipboard
class
Optional CSS classes to be assigned to the button (defaults to tc-btn-invisible)
TiddlyWiki includes over 100 custom vector icons. They feature in the user interface and are also available for authors to use in their own applications. See Icon Gallery for a complete listing.
Usage
The core icons are used by transcluding them. For example:
{{$:/core/images/new-image-button}}
Affichera ceci :
The core icons are parameterised. The first parameter size specified the size at which the icon should be rendered:
Some icons take further parameters to customise how they are rendered. For example, the $:/core/images/new-journal-button icon takes an additional parameter day that specifies the day of the month that should be shown on the calendar. It defaults to the current date if not specified
The core icons are implemented as embedded SVG elements, and not as full-blown SVG images. This means that they can be styled using CSS. For example, the CSS property fill can be used to change the colour of the icons. For example:
By default, TiddlyWiki displays a blank screen while it is loading. You can add a special "splash screen" that is displayed while the wiki loads.
Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class tc-remove-when-wiki-loaded. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
Here's an example of a simple splash screen that just displays the text Loading. To use it, copy the text into a new tiddler, give it the type "text/plain" and the tag "$:/tags/RawMarkupWikified/TopBody":
If the tiddler is given the WikiText type text/vnd.tiddlywiki then the contents are wikified as the file is saved, allowing transclusion etc. For example, here's an example that quotes the site title in the loading message. To use it, copy the text into a new tiddler, give it the type "text/vnd.tiddlywiki" and the tag "$:/tags/RawMarkupWikified/TopBody":
\rules only filteredtranscludeinline transcludeinline
<div class="tc-remove-when-wiki-loaded">
Please wait while {{$:/SiteTitle}} is loading
</div>
The \rules directive is used to limit the wikitext syntax that is recognised to the two forms of inline transclusion. This avoids accidental wikification of tiddler content.
There is a more complex example splash screen using CSS animations and images configured in this wiki: see $:/SplashScreen
Vous créez un tiddler soit en cliquant sur le bouton du menu latéral, soit en cliquant sur un lien vers un tiddler absent. Les liens vers les tiddlers absents sont affichés en italique bleu.
Pour modifier un tiddler existant, cliquez sur le bouton en haut et à droite du tiddler.
Mode ébauche
Quand vous créez un nouveau tiddler ou modifiez un existant, le tiddler passe en mode ébauche. Ce mode propose un panneau de contrôle pour apporter différents types de modifications. Il a plusieurs parties, de bas en haut :
Le champ titre - pour modifier le titre du tiddler
Le sélecteur de tags - pour ajouter ou supprimer des tags. Lors de la saisie d'un tag, une liste déroulante affiche les tags correspondant sous forme de complétions. Vous pouvez choisir dans cette liste ou créer un tag entièrement nouveau. Puis cliquez sur le bouton ajouter ou utilisez la touche Entrée pour ajouter le tag au tiddler. Chaque tag est affiché sous forme d'une pilule colorée. Cliquez le "×" d'une pilule pour supprimer le tag
La zone de texte - pour modifier le contenu principal du tiddler. Cliquez sur le bouton afficher la prévisualiation ( / ) pour visualiser l'apparence des modifications
Le sélecteur de type - pour afficher vos tiddlers dans un format spécial, comme une image. Voir ContentType pour la liste des options. Le choix par défaut est text/vnd.tiddlywiki, qui indique que le tiddler contient du WikiTexte
Le sélecteur de champ - pour ajouter ou supprimer des champs du tiddler. Par exemple, si vous modifiez un tiddler utilisé comme tag par d'autres tiddlers, vous pouvez ajouter un champ ''list'' pour modifier l'ordre dans lequel ces tiddlers seront listés
Confirmer, annuler ou supprimer
Quand vous avez terminé les modifications, cliquez sur le bouton en haut et à droite du tiddler :
Le bouton confirmer () mémorise vos modifications dans le tiddler et quitte le mode ébauche. Si votre wiki est configuré en Sauvegarde automatique, vos modifications seront enregistrées de façon permanente. Autrement elles sont mémorisées temporairement dans votre navigateur web, et vous les perdrez si vous fermez votre page TiddlyWiki sans avoir cliqué sur le bouton principal pour Enregistrer () dans le menu latéral.
Le bouton annuler () ignore vos modifications (après demande de confirmation) et quitte le mode ébauche.
Le bouton supprimer () supprime tout le tiddler (après demande de confirmation).
Les tiddlers journaux sont des tiddlers dont le titre est composé d'une date et/ou d'une heure. Ils sont très utiles à l'enregistrement d'informations horodatées.
Vous pouvez ajouter des tags à votre tiddler journal pour le relier à d'autres tiddlers ce qui aidera à établir des relations entre les éléments d'information.
Par exemple, vous pourriez utiliser un tiddler journal appelé 10 Octobre 2014 pour enregistrer les idées et les informations capturées en ce jour particulier. Les tags Shopping et Londres mentionnant ce qui concerne le shopping à Londres.
Création d'un tiddler journal
La façon la plus simple de créer un tiddler journal est un clic sur le bouton nouveau journal dans l'onglet Outils du menu latéral. Si vous utilisez souvent le bouton, cliquez sur la case à cocher proche ce qui le placera juste au dessus de la zone de recherche.
Le bouton nouveau journal génère un journal correspondant à un tiddler vierge avec un tag Journal et un titre mentionnant la date du jour. Si un tiddler journal avec cette date existe déjà, il sera ouvert pour modification.
Création d'un tiddler journal tagué
Une suite d'actions courante sera la création (ou la réouverture) d'un tiddler journal du jour tagué avec le titre d'un autre tiddler. Cela pourra être effectué par le bouton nouveau journal ici de la barre d'outil du tiddler autre. Vous trouverez ce bouton dans l'onglet Outils du panneau d'information du tiddler.
Par exemple, lors de la révision d'un tiddler appelé Oxford Street , vous pourriez vous rendre compte de sa pertinence pour la préparation de votre tournée des magasins. Cliquer sur le bouton nouveau journal, ici dans le tiddler Oxford Street pour générer une entrée du journal étiquetée du tag Oxford Street.
Personnalisation des tiddlers journaux
Pour régler la façon dont les nouvelles entrées des journaux sont créés, rendez-vous à l'onglet Fondamentaux sous Info dans le panneau de contrôle:
Gabarit pour les titres des tiddlers journaux spécifie la façon dont ces tiddlers seront nommés, par une chaine de format date. Le réglage par défaut sur DDth MMM YYYY permet aux nouvelles entrées d'avoir des titres de la forme "10 Octobre 2014"
Tags pour les nouveaux tiddlers journauxspécifie les tags que contiendront automatiquement les nouveaux journaux. Par exemple: Journal [[Vacances d'été]]
Astuce: si vous souhaitez créer un tiddler journal différent à chaque fois que vous cliquerez sur nouveau journal (et ce plusieurs fois dans la même journée), vous pourriez inclure l'heure dans le format du titre, par exemple de cette façon AAAA-0MM-0DD au 0hhh0mm'0ss''.
Une autre astuce utile est d'inclure $(currentTiddler)$ quelque part dans le format du titre. Ainsi, si vous cliquez sur nouveau journal ici dans plusieurs tiddlers différents, les titres de chacun de ces tiddlers feront partie du nom des entrées de journal qui en résultera.
Let's say you have a skeleton tiddler called 'Recipe template', and you want to have a button available in the tiddler ViewToolbar to create new recipe tiddlers on demand. This will require the following steps:
You will want an image for your button. If none of the core images (shadow tiddlers with the prefix $:/core/images/) work for you, then you will need to create or acquire an SVG image (for example, one of the images at http://flaticon.com), drag it into your file so that it becomes a tiddler, edit the tiddler and adjust the height and width to 22px
You will want to create the tiddler that contains your tiddler. Create it, title it, and add the button code (see the code at the bottom of this tiddler for an example, with hints where you will need to adapt it). Tag it $:/tags/ViewToolbar
You will need to create a tiddler that tells TiddlyWiki whether your button should be visible in the toolbar or hidden. Let's title it $:/config/ViewToolbarButtons/Visibility/Recipe. Type show into the text area, and save. If you want to hide it, type hide into the text area and save. The button will also be accessable from the ControlPanel : Appearance : Toolbars : ViewToolbar tab
You will want to position the button properly. Open the tiddler $:/tags/ViewToolbar and insert your button tiddler's title in the appropriate place in the list field.
\define newHereButtonTags()
[[$(currentTiddler)$]]
\end
\define newHereButton()
<$button class=<<tv-config-toolbar-class>>>
<$action-sendmessage
$message="tm-new-tiddler"
$param="TITLE OF YOUR SKELETON BUTTON"
title="New tiddler"
tags=<<newHereButtonTags>> />
<$list filter="[<tv-config-toolbar-icons>match[yes]]">
{{TITLE OF YOUR SVG IMAGE TIDDLER}}
</$list>
<$list filter="[<tv-config-toolbar-text>match[yes]]">
<span class="tc-btn-text"><$text text="CAPTION FOR YOUR BUTTON"/></span>
</$list>
</$button>
\end
<<newHereButton>>
Cet exemple montre comment créer un déroulé imbriqué avec un tiddler indépendant du déroulé principal.
Voilà le code :
<$navigator story="MySubStoryList" history="MySubHistoryList">
Cliquez sur ce lien pour commencer: HelloThere
<$list filter="[list[MySubStoryList]]" history="MySubHistoryList">
<div>
! <$button message="tm-close-tiddler" class="tc-btn-invisible">{{$:/core/images/close-button}}</$button> <$view field="title"/>
<$transclude/>
</div>
</$list>
</$navigator>
Notez comment vous pouvez ouvrir le tiddler Bienvenue
dans un déroulé imbriqué en cliquant sur le lien suivant. Les liens du déroulé imbriqué s'ouvre indépendament du déroulé principal.
Le tiddler courant fournit le contexte dans lequel plusieurs aspects de Wikitext sont interprétés.
Par exemple, {{!!title}} se réfère à la valeur du champ title du tiddler devenu courant, quel que soit-il. Cette technique peut être utilisée pour créer des tiddlers gabarit d'usage général.
Le titre du tiddler courant peut toujours être trouvé dans la variable currentTiddler.
Les deux façons les plus communes de modifier le tiddler courant sont :
Plusieurs aspects de WikiText ont ce tiddler en contexte. Comme résultat, dans un widget $list ou via un tiddler gabarit, il n'est pas souvent nécessaire de spécifier explicitement le titre du tiddler.
So to display tiddlers tagged: data-tags-styles in a decent way we can use the following code. (I could have used: $:/tags/Stylesheet, but that would affect all stylesheets in this wiki, which is not intended. amt ;)
Important: Don't forget to also specify .tc-tiddler-body or the whole tiddler, including the title, will be changed! see: Custom data-styles
This mechanism may be handy for users who want to write prose text! See: Hard Linebreaks with CSS
More Possibilities
[attr]
Represents an element with an attribute name of attr.
[attr="value"]
Represents an element with an attribute name of attr and whose value is exactly "value".
[attr~="value"]
Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
[attr|="value"]
Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
[attr^="value"]
Represents an element with an attribute name of attr and whose first value is prefixed by "value".
[attr$="value"]
Represents an element with an attribute name of attr and whose last value is suffixed by "value".
[attr*="value"]
Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
[attr "operator value" i]
Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
The TiddlyWiki core adds several attributes to the rendered content. With those attributes it's possible to apply custom styles to the tiddler content.
For example this tiddler is named: "Custom styles by data-tiddler-title" so the attribute looks like this:
data-tiddler-title="Custom styles by data-tiddler-title"
Examples
The following CSS is defined in Custom data-styles and creates a blue border for exactly this tiddler.
[data-tiddler-title="Custom styles by data-tiddler-title"] {
border: 1px solid blue;
}
To create a green border for every tiddler that starts with $:/ aka system tiddlers, you'd need to use CSS like so: (not applied here but you can experiment with it! )
Represents an element with an attribute name of attr.
[attr="value"]
Represents an element with an attribute name of attr and whose value is exactly "value".
[attr~="value"]
Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
[attr|="value"]
Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
[attr^="value"]
Represents an element with an attribute name of attr and whose first value is prefixed by "value".
[attr$="value"]
Represents an element with an attribute name of attr and whose last value is suffixed by "value".
[attr*="value"]
Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
[attr "operator value" i]
Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
The tag manager allows us to set a tiddler color field, that is used to define the "tag-pill" colour. Since: Depuis : 5.1.16 we can define a class field, that is directly inserted into the ViewTemplate and it can be used for styling:
Depuis : 5.2.0 The attribute data-tag-title was added to tag pills visible in the tiddler view template.
Depuis : 5.3.0 The attribute was added to every tag pill visible in the standard TiddlyWiki UI. Especially the edit template tag list, the tag-picker dropdown, the Right sidebar -> More -> Tags tab and the $:/TagManager
The data-tag-title HTML attribute only contains the tag-title visible in the tag pill. It can be used to style the tag-pill.
If you use the following CSS in a new tiddler tagged: $:/tags/Stylesheet every tag that starts with a # will have a new border radius. So those tags stand out in contrast to the default tags.
You have to define both CSS rules, due to the existing UI structure to catch all tag-pills in the existing TW UI.
Represents an element with an attribute name of attr.
[attr="value"]
Represents an element with an attribute name of attr and whose value is exactly "value".
[attr~="value"]
Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
[attr|="value"]
Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
[attr^="value"]
Represents an element with an attribute name of attr and whose first value is prefixed by "value".
[attr$="value"]
Represents an element with an attribute name of attr and whose last value is suffixed by "value".
[attr*="value"]
Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
[attr "operator value" i]
Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Depuis : 5.3.0 A custom widget is a special kind of procedure that can be called using the same syntax as widgets.
Custom widgets can also be used to override built-in JavaScript widgets to customise their behaviour.
Defining Custom Widgets
Custom widgets are usually defined with the Pragma: \widget:
\widget $my.widget(attribute:"Default value")
This is the widget, and the attribute is <<attribute>>.
\end
The name of the widget must start with a dollar sign. If it is a user defined widget that does not override an existing widget then it must include at least one period (dot) within the name (for example $my.widget or $acme.logger).
Note that the Pragma: \whitespace setting is inherited from the parsing context in which the procedure definition occurs. That means that a tiddler containing multiple procedure definitions only needs a single whitespace pragma at the top of the tiddler, and the setting will be automatically inherited by the procedure definitions without needing the pragma to be repeated.
Using Custom Widgets
Custom widgets are called in the same way as ordinary built-in widgets:
The attributes that are specified in the widget call are made available as parameter variables.
Accessing Content of Custom Widgets
Within the definition of a custom widget the content of the calling widget is available via the <$slot $name="ts-raw"/> widget. The contents of the $slot widget is used as the default content if the widget was called without any content.
Custom widgets are implemented as a special kind of variable. The only thing that distinguishes them from ordinary variables is the way that they can be called as a custom widget with attributes mapped to parameters.
Overriding Core JavaScript Widgets
Custom widgets can use the $genesis widget to invoke the original widget, bypassing the override. For example, here we override the $codeblock widget to add ≤≥ symbols around each string of text.
Par défaut les résultats de la recherche du menu latéral sont affichés comme une simple liste de titres de tiddler. Ce résultat de recherche peut être personnalisé en ajoutant des plugins de visualisation qui les montreront de différentes façons. (les onglets sont affichés automatiquement si un résultat de recherche additionnel est détecté).
Les visualisations des résultats de recherche sont mémorisés dans les tiddlers étiquetés $:/tags/SearchResults. La liste de résultats de recherche par défaut est implémentée dans le tiddler système $:/core/ui/DefaultSearchResultList.
Pour créer un nouvel affichage de liste de recherche :
Utilise la variable widget searchTiddler pour accéder au titre de chaque tiddler contenant les termes de la recherche en cours
Si vous voulez faire du nouvel affichage celui du résultat de recherche par défaut, créez un tiddler appelé $:/config/SearchResults/Default contenant le titre de cet affichage.
Voici un exemple d'affichage montrant les résultats dans l'ordre chronologique inverse :
By default, a TiddlyWiki on Node.js instance using a wiki folder will create new tiddler files by using the sanitised and disambiguated title as filename. All filepath operations are relative to a default-tiddler-location which defaults to the wiki folder's tiddlers/ directory. This can be overridden by mapping a path in the wiki's tiddlywiki.info file, by using a default-tiddler-location property in the config object.
The default file extension of .tid is used for tiddlers that are missing the type field, or for tiddlers of type "text/vnd.tiddlywiki". Tidders of other types are saved according to their MIME types (defined at boot startup).
The logical path can be customised by creating a $:/config/FileSystemPaths tiddler containing one or more filter expressions, each on a line of its own. Every time a tiddler is saved to disk it is tested against each filter in turn, and the first output of the first filter to produce any output is taken as a logical path to be used for the tiddler file. If the logical path has changed a new file is created and the old file is deleted.
Tiddlers are limited to being written to the wiki folder, the path defined in the default-tiddler-location setting, or the specific path saved in the $:/config/OriginalTiddlerPaths tiddler (see tiddlywiki.files Files). Any error saving a tiddler to disk, with a logical path that does not start with the wiki folder's path the most common error, causes the filepath to be encoded via Javascript's encodeURIComponent() method and the tiddler is saved as this file in the wiki folder's default-tiddler-location.
Logical paths do not include the file-on-disk's extension (see below), and they can use / or \ as directory separator (when generating the physical path, this is replaced by the correct separator for the platform TiddlyWiki is running on). If none of the filters match, the logical path is simply the title with all occurrences of the characters /\<>~:"|?*^ replaced by _ in order to guarantee that the resulting path is legal on all supported platforms. Logical paths are also limited to 200 characters. If a file with this name already exists, a space and a number will be appended to the final filepath, and with the number incremented until an unused path is found.
All paths are relative to the wiki's default-tiddler-location.
This will store newly created system tiddlers that are not drafts of other tiddlers in ./_system/ (after stripping the $:/ prefix). Next, all drafts have the path separator characters in their titles replaced by "_" and are stored in ./drafts/. Then tiddlers tagged task are stored in a subdirectory ./mytasks/. Finally, all tidders not tagged with "externalnote" will match the final [!tag[externalnote]addprefix[wiki/]] storing these in ./wiki/. In this example, tiddlers tagged with "externalnote" have been imported using tiddlywiki.files Files with an "isEditableFile" flag set to true, causing the server to remember their original file path in the $:/config/OriginalTiddlerPaths tiddler.
Whenever a tiddler generates a $:/config/FileSystemPaths filter match, any / or \ in the tiddler title is mapped to a path separator. With the above filters, the non-system, non-draft tiddler titled some/thing/entirely/new (with no tags) will be saved to ./wiki/some/thing/entirely/new.tid (ie, the file new.tid in a directory called entirely/). Thus, $:/config/FileSystemPaths itself will end up in ./_system/config/FileSystemPaths.tid or .\_system\config\FileSystemPaths.tid, depending on the platform.
File System Extensions
Normally, the file system extension of a tiddler on disk is determined by the presence of field values containing newlines or field values that start or end with whitespace (other than the text field), in which case the single file ".json" tiddler file format is used.
If the tiddler does not have such field values, then the type field is referenced to find a matching file-type, with .tid used for tiddlers without a type value. The boot engine defines a set of these tiddler-type to file-type relationships in the $:/boot/boot.js tiddler. Search for // Add file extension information to find the section of code that defines these relationships.
The file extension of individual tidders can be customised by creating a tiddler $:/config/FileSystemExtensions containing one or more filter expressions, each on a line of its own. Every time a tiddler is saved to disk it is tested against these filters, and the first output of the first filter to produce any output is taken as the file extension to be used for the tiddler file. Extensions should always start with a leading dot (see example). If no filter matches, the default extension is used. If the extension has changed a new file is created and the old file is deleted.
Note
A result of ".tid" will force the tiddler to be written to disk as a single-file text tiddler. A result of ".json" will force the tiddler to be written to disk as a single file tiddler in json-format (a single tiddler fields object in an array), NOT as a tiddler of type "application/json". All other recognised file-types will be saved using their defined extension along with an accompanying *.meta file of the same name which describes all fields but the "text" field.
This will cause all tidders that have the tag ".txt" to be saved at the filepath determined by the File System Paths filters, but with their text field saved as a *.txt file, and all other fields saved as a *.txt.meta file.
Next, all tiddlers that have the ".json" tag are saved as *.json files. Finally, all tiddlers that have tag ".tid" are saved as single files. If a tiddler matches none of the filters, the default extension determined by the tiddlers type field would be used.
TiddlyWiki’s user interface is designed to be highly extensible. Every element can be augmented, removed, or rearranged.
Several different mechanisms are used to achieve this:
special fields
special titles
special tags
cascades
Here we provide an overview of those mechanisms and how they relate together.
Special Fields
Special fields are used to assign an appearance or behaviour to individual tiddlers. They can be thought of as flags or values that directly control the tiddler to which they are applied.
For example:
Set the icon field to the title of an image tiddler to be used as the icon for this tiddler
Set the color field to a CSS colour that is then used for icons and tag pills associated with this tiddler
Set the hide-body field to yes to hide the view template body for this tiddler
See TiddlerFields for details of all the special fields.
Special Titles
Certain special titles identify configuration tiddlers that customise TiddlyWiki's appearance or behaviour. They can be thought of as global settings that affect an entire wiki.
For example:
$:/DefaultTiddlers is a filter yielding the titles of the tiddlers that should be displayed at startup
$:/config/Tags/MinLength controls the minimum number of characters to trigger tag autocompletion
Many of TiddlyWiki's configuration tiddlers are presented as options in $:/ControlPanel. Less commonly used configuration tiddlers do not have a user interface, but are documented in Hidden Settings.
Special Tags
Special tags assign special behaviour or appearance to all of the tiddlers to which they are applied. They can be thought of as establishing ordered lists of tiddlers that are processed or displayed in a particular way.
For example:
$:/tags/Global causes the definitions in a tiddler to be available globally
$:/tags/Stylesheet causes the tiddler to be interpreted as a CSS stylesheet
$:/tags/SideBar causes the tiddler to be displayed as a sidebar tab
See SystemTags for details of all the special tags.
The entire TiddlyWiki user interface is constructed from lists formed from special system tags.
The ordering of these lists is determined by the order of tagged tiddlers rules. Users can re-order tags using drag and drop within a tag dropdown.
Cascades
Cascades provide a means to select one of multiple values based on flexible, extensible criteria. They can be thought of as a list of conditions that are evaluated in turn until one of them matches.
For example, the core uses the template $:/core/ui/ViewTemplate to display tiddlers in view mode, and $:/core/ui/EditTemplate to display tiddlers in edit mode. A cascade is used to choose which template to use for a particular tiddler:
When editing a tiddler the EditTemplate normally renders fields as simple input boxes. To modify this behaviour, the cascade mechanism can be used. Via the Field Editor Cascade the name of the tiddler used for rendering the field editor can be specified. The content of this tiddler is transcluded to represent the content of the field.
To modify the appearance of all fields whose name ends with -date create a new tiddler and add the $:/tags/FieldEditorFilter tag to it. Add a list-before field and assign the value $:/config/FieldEditorFilters/default. Now you have to put the filter for the cascade into the tiddler's text field: [suffix[-date]then[$:/config/EditTemplateFields/Templates/dates]]. This will transclude the tiddler named $:/config/EditTemplateFields/Templates/dates to render the input elements for all fields with names matching the regular expression.
The variables currentTiddler, currentField and currentFieldName are set to pass information about the tiddler and field that are edited to the transcluded tiddler.
currentTiddler
The tiddler that must be used to store the field value.
currentField
The field within the currentTiddler that must be used to store the field name. This is an opaque value hat may contain any field name (even text), use currentFieldName to make decisions based on the actual name of the currently edited field.
currentFieldName
The name of the currently edited field.
For example, a tiddler containing the following WikiText would render the field as an HTML input element of the type date. This will show a date picker for the fields on all modern browsers:
The currentField variable will be set to text for new fields. Make sure that your editor will handle this correctly. For example, by setting the tag attribute on the EditTextWidget. If you want to know the name of the currently edited/added field, use the currentFieldName variable.
The tabindex and cancelPopups attributes make sure the HTML input element behaves exactly the default elements provided by TiddlyWiki.
Not only the EditTextWidget can be used. A tiddler containing the following WikiText will render the field as a drop-down-list that allows the user to select the name of a tiddler. The name of the selected tiddler will be stored in the field.
The classes tc-edit-texteditor and tc-edit-fieldeditor should be used to style the input and select elements to match the theme of the TiddlyWiki installation.
Persistence of values when creating fields
When using multiple field editors for creating fields within the EditTemplate, every field editor tiddler returned by the Field Editor Cascade gets its own storage tiddler. This is done to prevent problems with incompatible values when the user is switching between fields governed by different field editors.
Example
There is a cascade that returns a special field editor for all fields starting with the string "my-". All other fields use the default field editor.
If you type a new value into the "field value" input box and select any field not starting with "my-", the value will be kept.
If you switch to a field, that starts with "my-", the "field value" input field will be empty again because a new type of field editor is used. If you now type a value and switch to another field starting with "my-" the value will be kept. If you switch to a field that does not start with "my-" the previously typed value (that was stored for the default editor) will reappear.
The cycle operator requires at least one parameter.
[cycle[<titles>],[step-size]]
titles : a title list to toggle in the input list cyclically. If no title from the parameter is present in the input, the first title is added. If a title from the parameter is present in the input, it is replaced with the next title from the parameter. Note that all titles specified in this parameter should be unique.
step-size: (optional). Defaults to 1. Specifies the number of steps in the parameter list to move each time. Can be a negative number.
While the cycle operator interprets its first parameter as a list of titles to cycle through, the toggle Operator accepts an unlimited number of distinct parameters and offers similar functionality.
Une data URI est un moyen de stocker des données (telles qu'une image) d'une façon compatible avec les adresses utilisées par les pages web et les feuilles de styles pour accéder à des ressources externes.
La macro datauri peut être employée pour générer des data URIs via TiddlyWiki.
The example has to invoke datauri through the $macrocall widget. It needs to prevent the macro's output from being parsed as WikiText, as that would transform the data URI into a $link widget and break the example. If the example was in a CSS tiddler, you could simply write:
Le WidgetView accepte un attribut template qui permet de spécifier le format d'affichage des dates. A la chaine formatée se substituent les valeurs suivantes :
Format
Valeur de Substitution
DDD
Jour de la semaine en entier (ex, "Monday")
ddd
Jour de la semaine abrégé (ex, "Mon")
DD
N° du jour dans le mois
0DD
Éventuel préfixe d'un zéro
DDth
Ajout d'un suffixe
WW
ISO-8601 n° de la semaine
0WW
Éventuel préfixe d'un zéro
MMM
Mois en entier (ex, "July")
mmm
Mois abrégé (ex, "Jul")
MM
N° du mois
0MM
Éventuel préfixe d'un zéro
YYYY
Année en entier
YY
Année sur 2 chiffres
wYYYY
Année complète avec numéro de la semaine
wYY
Année abrégée avec numéro de la semaine
hh
Heures
0hh
Éventuel préfixe d'un zéro
hh12
Heures au format 12 heures
0hh12
Éventuel préfixe d'un zéro
mm
Minutes
0mm
Éventuel préfixe d'un zéro
ss
Secondes
0ss
Éventuel préfixe d'un zéro
am/pm
Indicateur AM/PM en minuscule
AM/PM
Indicateur AM/PM en majuscule
TZD
Zone horaire
\x
Utilisation du caractère d'échappement pour insérer des caractères sans interpréter le formatage
Notez que tout autre texte sera affiché sans générer de modification, ce qui permet d'utiliser des virgules, les deux points ou tout séparateur utile.
datepicker is a TiddlyWiki plugin that allows you to use a widget much like EditTextWidget to pick a date, and optionaly a time. It shows a nice interactive mini-calendar when clicked, allows you to set a date format for display, and is compatible with core date fields such as modified and created.
The core shadow tiddler $:/snippets/DebugStylesheets contains a simple tool for tracking down certain problems with mismatched brackets and other nested structures.
In the list below, any stylesheets containing an error will be marked with a red cross:
The keyboard-driven-input Macro is used to create filtered lists that update as the user types. It also allows navigating the lists, and invoking macros using list items, with the keyboard.
It consists of an edit-text widget wrapped in keyboard widgets. There are keyboard widgets to listen for ((input-accept)), ((input-accept-variant)), and ((input-cancel)) keyboard shortcuts, but there is no default behaviour in response to these events; macros must be written to suit the use-case. There is also no default visualisation of the filtered options list.
Types of keyboard input handled by the keyboard-driven-input macro:
temporarily selecting the previous item in the filtered list
input-next-actions with parameters afterOrBefore="before", reverse="reverse[]"
((input-down)) (
Down
)
temporarily selecting the next item in the filtered list
input-next-actions with afterOrBefore="after", reverse=""
All of the above actions generate or modify data which keyboard-driven-input keeps in tiddlers specified using the macro's parameters. The data can then be accessed not only by the macros invoked by keyboard shortcuts, but also outside of these, e.g. a macro to display the filtered list(s).
Configurable through parameters:
The following keyboard events invoke macros whose names are specified in parameters to keyboard-driven-input. The intended purpose is suggested by the parameter name, but there are no default macros defined within $:/core/macros/keyboard-driven-input.
Keeping in mind that the keyboard-driven-input macro does not, by itself, display list results, or do anything with a selected option, a minimal demonstration of the keyboard-driven-input macro requires:
a tiddler, containing a filter whose results depend on the user's text input, to generate the options from which the user can select
several parameters:
a filter to return the title of the tiddler where the filter described in step 1 can be found, and
tiddler titles to use for storing state information in response to input events. These tiddlers do not need to exist already. If they do exist, the keyboard-driven-input macro will change their contents.
The search filter(s)
By default, keyboard-driven-input will look for filters in the first-search-filter and second-search-filter fields of a tiddler (whose title is specified by a parameter discussed below).
This filter can refer to a variable called userInput, which shows the contents of the edit-text widget, as stored in a state tiddler (discussed below), at the time of the latest Up or Down event.
Note: If this filter is to be referred to in a context outside the keyboard-driven-input macro (such as in a popup showing the filtered options), the variable userInput has to be defined in those contexts as well (by reading it from a state tiddler).
Minimal parameters
Parameter name
Notes
configTiddlerFilter
This is a filter, rather than a tiddler title, allowing conditional behaviour (e.g. checking for an active tab, or preferring a filter that may not be present, with a fallback). The title returned must belong to an existing tiddler, containing at least one filter with which keyboard-driven-input can generate its results list.
tiddler
This tiddler contains either the typed input, or the instantaneous result selection, depending upon the most recent event. It is updated with each keystroke in the edit-text widget, and when the user uses the Up or Down key to cycle through filtered results.
storeTitle
This tiddler always reflects the user input (transcluded from the tiddler tiddler after each keystroke into the edit-text widget).
selectionStateTitle
This tiddler is updated on Up or Down events and contains either the user input with the suffix -userInput, or the instantaneous selection with the suffix -primaryList or -secondaryList, depending on which of up to two filters generated the list it came from.
Demonstration setup
I have created a tiddler called kdi-demo-configtid and put the following filter into its first-search-filter field:
[!is[system]search:title<userInput>sort[]].
This filters for non-system tiddlers whose titles contain the text the user has typed.
To use the above filter with keyboard-driven-input, the value of the parameter configTiddlerFilter should be a filter that returns kdi-demo-configtid.
I can select tiddler, storeTitle, and selectionStateTitle fairly arbitrarily (just making sure not to use titles of tiddlers that I do not want changed).
This demonstration can now be invoked with the following macro call:
Observe the changes in the various state tiddlers in the below table. Use Up and Down keys to navigate among filter results. If nothing changes, try a shorter input to widen the filter. If the input has zero length, the list will contain all non-system tiddlers.
The keyboard-driven-input macro has many parameters available, including all the attributes of the enclosed edit-text widget, which make it very flexible in how it is used and how results can be displayed and interacted with.
L'obsolescence est, dans le domaine du développement logiciel, la situation où une ancienne fonctionnalité est considérée comme dépassée au regard d'un nouveau standard, et où, bien qu'elle soit conservée dans les versions plus récentes (par souci de rétro-compatibilité, et pour donner aux développeurs le temps de mettre leur code source en conformité), elle pourrait disparaître à l'avenir, si bien qu'il est recommandé d'en abandonner l'usage.
Pour TiddlyWiki, cela signifie que vous ne devriez plus utiliser ce mécanisme pour du nouveau contenu, et que vous devriez mettre à jour votre contenu existant !
Deserializer modules parse text in various formats into their JSON representation as tiddlers. The deserializer modules available in a wiki can be seen using the deserializers operator and can be used with the deserialize Operator.
The TiddlyWiki core provides the following deserializers:
Deserializer
Description
(DOM)
Extracts tiddlers from a DOM node, should not be used with the deserialize[] operator
application/javascript
Parses a JavaScript module as a tiddler extracting fields from the header comment
Deserializer modules parse text in various formats into their JSON representation as tiddlers. The deserializer modules available in a wiki can be seen using the deserializers operator and can be used with the deserialize Operator.
The TiddlyWiki core provides the following deserializers:
Deserializer
Description
(DOM)
Extracts tiddlers from a DOM node, should not be used with the deserialize[] operator
application/javascript
Parses a JavaScript module as a tiddler extracting fields from the header comment
J'ai travaillé sur une nouvelle version de TiddlyWiki à partir de novembre 2011. En tant que programmeur, travailler à une « version 2.0 » de quelque chose que j'avais déjà écrit était une projet très séduisant. Cela signifiait que les besoins étaient bien compris, et je pouvais dès lors me concentrer sur l'architecture et ses évolutions nécessaires à la mise en œuvre des fonctionnalités désirées.
Depuis : 5.1.16 The diff text widget analyses the differences between a pair of source and destination text strings and displays the results as highlighted insertions and deletions (similar to the "track changes" function of a word processor). For example:
8 différences
Hey Jude, don't make it bad. Take a sad song and make it better. Remember tobe afraid. You were made to go out and get her. The minute you let her intounder your heart↩︎
skin. Then you can startbegin to make it better.
Content and Attributes
Content
The content of the <$diff-text> widget is rendered immediately before the diffs. Within it, the variable diff-count is available, containing the number of differences found. If the widget has no content then it automatically transcludes the tiddler $:/language/Diffs/CountMessage.
In other words, these three invocations are all equivalent:
À moins que vous n'ayez déjà observé TiddlyWiki en action, nous pouvons vous garantir que vous n'avez jamais rien vu de semblable. TiddlyWiki est :
un outil,
une boîte à outils,
une communauté,
et une philosophie.
TiddlyWiki est un outil
TiddlyWiki est d'abord et avant tout un outil : un outil libre et gratuitement téléchargeable, qui sert à conserver et organiser du contenu, qu'il provienne du Web, de vos documents, ou de votre cerveau. Il s'agit d'un outil de prise de notes, d'annotation, de gestion de signets et de mémos, d'écriture, de gestion de projets et de listes de choses à faire, de collaboration, de blog, et d'édition.
Avec TiddlyWiki, vous créez ou collez du contenu dans des notes appelées tiddlers, puis vous connectez vos tiddlers avec des hyperliens et des tags. Vous pouvez ensuite retrouver vos notes facilement grâce à des fonctions comme des nuages de tags, des onglets latéraux, ou la fenêtre de recherche ultra rapide de TiddlyWiki. Vous pouvez même inclure dynamiquement le contenu d'un tiddler dans un autre — comme on assemble un jeu de construction — pour créer des articles, des listes, des présentations, etc.
TiddlyWiki est une boîte à outils
En plus d'être un outil multi-fonctions, TiddlyWiki est aussi une boîte à outils.
Là où d'autres produits de prises de notes commencent par vous attirer avec l'application de base, pour vous faire ensuite payer les fonctions réellement utiles, TiddlyWiki contient une collection de thèmes, palettes, plugins, widgets et macros, entièrement gratuits et en constante augmentation. Vous pouvez les combiner dans tous les sens pour corriger et remodeler votre TiddlyWiki à votre guise.
TiddlyWiki est aussi une communauté
Nous sommes une communauté d'utilisateurs et de développeurs qui s'aident mutuellement, imaginent de nouvelles façons de penser et d'organiser les connaissances, et créent de nouvelles solutions, afin d'adapter constamment TiddlyWiki aux besoins des utilisateurs. Les utilisateurs et les développeurs de TiddlyWiki partagent questions et conseils sur un forum Google dédié. Ils créent également des tutoriels, des adaptations et des plugins qui amélioreront votre expérience de TiddlyWiki. Rendez-vous à la section Communité de la table des matières pour plus de détails.
Enfin, TiddlyWiki est une philosophie
Prendre des notes et les organiser (et conserver toutes sortes de contenu) n'a d'intérêt que si vous êtes en mesure de les retrouver plus tard. Sinon, l'acte de prendre des notes n'est qu'une colossale perte de temps.
La philosophie de TiddlyWiki soutient que le meilleur moyen de prendre des notes consiste à les séparer en tiddlers, les plus petites unités sémantiques possibles. Un tiddler peut être une image, un lien sur une page web, la définition d'un terme, ou du code de personnalisation, comme une macro.
Ces tiddlers peuvent être ensuite combinés pour créer des unités plus longues : déroulés, articles, listes, galeries d'images, etc. Les fonctions de TiddlyWiki comme l'étiquetage, les références croisées et les filtres, sont conçues spécifiquement pour vous aider à associer et connecter les tiddlers de plusieurs manières, afin de faciliter la récupération de vos notes, voire vous aider à découvrir des relations inattendues entre vos tiddlers et l'information qu'ils contiennent.
Use this plugin to give your visitors the opportunity to comment on your tiddlers without changing the wiki itself.
Disqus is a networked community platform used by hundreds of thousands of sites all over the web. With Disqus, your website gains a feature-rich comment system complete with social network integration, advanced administration and moderation options, and other extensive community functions.
Le DOM d'une page web est une représentation arborescente de son contenu, maintenue en interne pas le navigateur web pendant que l'utilisateur interagit avec ce contenu. Chaque intersection de l'arbre est appelée nœud (node).
Quand TiddlyWiki s'exécute dans un navigateur web, ses widgets interprètent les nœuds du DOM pour les afficher.
Quand TiddlyWiki est exécuté sur Node.js, il utilise un faux DOM pour simuler le comportement du navigateur.
Les macros suivantes sont utilisées tout au long de la documentation de TiddlyWiki. Leurs noms commencent par un point pour les séparer de celles que les utilisateurs ont l'habitude d'expérimenter.
Général
Macro
Utilisé pour
Exemple
.def
l'occurrence d'un terme défini
widget
.em
mise en valeur mineur dans une phrase
non
.place
un emplacement à saisir par l'utilisateur
nomtag
.strong
mise en valeur majeur dans un tiddler
Important!
.word
la mention d'un mot ou une phrase ordinaire
"Salut à tous"
Avis
Macro
Utilisé pour
Exemple
.tip
Astuces & infos
Allumez votre écran, ou vous n'en verrez pas plus.
La documentation de TiddlyWiki tente de suivre les règles suivantes. L'objectif est de s'assurer que la documentation issue d'auteurs différents se lira de façon aussi homogène que possible.
Adressez-vous au lecteur directement en disant "vous"
Évitez la voix passive dans vos tutoriels et vos présentations
Lorsque vous écrivez en Anglais, utilisez l'Anglais britannique de préférence à l'Anglais des États-Unis. En Français, si vous utilisez des expressions qui ne sont pas employées en France, reliez-les à un tiddler qui les replace dans leur contexte.
Les filtres manipulent des sélections de titres où aucun titre n'apparait plus d'une fois. En outre, ils ont souvent besoin d'ajouter tel ensemble à un autre.
Cet ajout s'effectue d'une façon telle que, si un titre vient à être dupliqué, la copie antérieure de ce titre est éliminé. Les titres ajoutés sont prépondérants.
Par exemple, si une sélection contient Andrew Becky Clara Daniel et que Andrew Barney Clara Daisy lui est ajouté, le résultat sera Becky Daniel Andrew Barney Clara Daisy.
Les Tiddlers qui ont un champ draft.of sont traités comme les ébauches en suspens des tiddlers indiqués dans le champ. Les tiddlers d'ébauche ont aussi un champ draft.title spécifiant le titre qui sera donné au tiddler après validation.
Plusieurs fonctionnalités fonctionnent de concert afin d'obtenir le comportement souhaité des tiddlers d'ébauche :
Le ListWidget peut éventuellement afficher les tiddlers ébauche via un gabarit différent
Le NavigatorWidget inclut des particularismes concernant les événements suivants :
tm-new-tiddler pour créer un nouveau tiddler en mode ébauche
tm-edit-tiddler pour mettre un tiddler en mode édition
tm-cancel-tiddler pour annuler un tiddler en mode édition
tm-save-tiddler pour confirmer un tiddler d'ébauche
Les tiddlers en cours d'ébauche sont exclus automatiquement du champ des recherche
Tiddler manipulation via drag and drop is supported by the core user interface in the following contexts:
Entries in the "Open" tab of the sidebar can be reordered by drag and drop; new tiddlers can be opened by dragging their titles into the list
Entries within a tag pill dropdown can be reordered by drag and drop; new tiddlers can be assigned the tag by dragging their titles into the list
Entries in the control panel "Appearance"/"Toolbars" tab can be reordered by drag and drop. (Less usefully, new entries can be added to the toolbars by dragging their titles into the list)
All tiddler links are draggable by default. They can be dragged within a browser window for manipulating tiddlers, or dragged to a different browser window to initiate an import operation
If you want to drag a link, first move it vertically, because horizontal movement is recognized by the browser as text selection.
Tag pills are also draggable, and are equivalent to simultaneously dragging all of the individual tiddlers carrying the tag.
Some common scenarios for drag and drop tiddler manipulation are available as reusable macros:
See DragAndDropMechanism for details of how to use the low level drag and drop primitives to build more complex interactions.
The standard HTML 5 drag and drop APIs used by TiddlyWiki are not generally available on mobile browsers on smartphones or tablets. The Mobile Drag And Drop Shim Plugin adds an open source library that implements partial support on many mobile browsers, including iOS and Android.
This tiddler discusses the internal mechanisms that are used to implement drag and drop features in TiddlyWiki. See Drag and Drop for a general description of the features.
TiddlyWiki uses the standard HTML 5 drag and drop APIs. However, this is an area that is rightly notorious for cross-browser compatibility problems. Therefore, some features that you might expect to work won't necessarily work in all browsers. In particular,
The following widgets are concerned with drag and drop features:
The DraggableWidget creates a draggable element that represents one or more tiddlers for dragging
The DraggableWidget creates a DOM element that can be dragged by the user. It only works on browsers that support drag and drop, which typically means desktop browsers, but there are workarounds.
The draggable element can be assigned a list of tiddlers that are used as the payload.
If desired it can invoke actions when dragging starts and when it ends.
See DragAndDropMechanism for an overview.
Content and Attributes
Attribute
Description
tiddler
Optional title of the payload tiddler for the drag
filter
Optional filter defining the payload tiddlers for the drag
tag
Optional tag to override the default "div" element created by the widget
selector
Depuis : 5.2.2 Optional CSS Selector to identify a DOM element within the widget that will be used as the drag handle
class
Optional CSS classes to assign to the DOM element created by the widget. The class tc-draggable is added to the the DOM element created by the widget unless the selector attribute is used. The class tc-dragging is applied to the DOM element created by the widget while the element is being dragged
enable
Depuis : 5.2.3 Optional value "no" to disable the draggable functionality (defaults to "yes")
startactions
Optional action string that gets invoked when dragging starts
endactions
Optional action string that gets invoked when dragging ends
dragimagetype
Depuis : 5.2.0 Optional type of drag image: dom (the default) or blank to disable the drag image
Either or both of the tiddler and filter attributes must be specified in order for there to be a payload to drag.
The actionTiddler Variable is accessible in both startactions and endactions. It holds the payload tiddler(s) specified through the tiddler and filter attributes as a Title List using double square brackets to quote titles that include whitespace.
Note that the actionTiddler Variable holds a Title List quoted with double square brackets. This is unlike the DroppableWidget which uses the same variable to pass a single unquoted title.
When specifying a DOM node to use as the drag handle with the selector attribute, give it the class tc-draggable in order for it to have the appropriate cursor and the attribute draggable with the value true to make it draggable.
All DOM attributes of the node being dragged are made available as variables, with the prefix dom-
tv-popup-coords
A relative co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see Coordinate Systems for more information)
tv-popup-abs-coords
Depuis : 5.2.4 An absolute co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see Coordinate Systems for more information)
tv-selectednode-posx
x offset position of the dragged DOM node
tv-selectednode-posy
y offset position of the dragged DOM node
tv-selectednode-width
offsetWidth of the dragged DOM node
tv-selectednode-height
offsetHeight of the dragged DOM node
event-fromselected-posx
x position of the event relative to the dragged DOM node
event-fromselected-posy
y position of the event relative to the dragged DOM node
The droppable widget creates a DOM element onto which dragged items can be dropped by the user, triggering the specified actions. It only works on browsers that support drag and drop, which typically means desktop browsers, but there are workarounds.
Optional CSS classes to assign to the draggable element. The class tc-droppable is added automatically, and the class tc-dragover is applied while an item is being dragged over the droppable element
tag
Optional tag to override the default of a "div" element when the widget is rendered in block mode, or a "span" element when it is rendered in inline mode
enable
Depuis : 5.1.22 Optional value "no" to disable the droppable functionality (defaults to "yes")
Within the action string, there are two Variables generated by the DroppableWidget:
This example displays a palette of icons. Dragging a tiddler onto one of the icons assigns that icon to the tiddler.
Similarly, this example shows a palette of colours. Dragging a tiddler onto one of the colours assigns that colour to be used for rendering the icon of the tiddler.
The dropzone widget creates an area into which the user can drag files and other objects. It also supports pasting via the clipboard, although browser support is currently limited.
It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers to be imported up through its parents. This message usually trapped by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.
Content and Attributes
Attribute
Description
deserializer
Depuis : 5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension)
enable
Depuis : 5.1.22 Optional value "no" to disable the dropzone functionality (defaults to "yes")
class
Depuis : 5.1.22 Optional CSS class to be assigned to the DOM node created by the dropzone (defaults to "tc-dropzone")
autoOpenOnImport
Depuis : 5.1.23 Optional value "no" or "yes" that can override tv-auto-open-on-import
importTitle
Depuis : 5.1.23 Optional tiddler title to use for import process instead of $:/Import
actions
Depuis : 5.2.0 Optional actions string to be invoked after the tm-import-tiddlers message has been sent. The variable importTitle provides the title of the tiddler used for the import process.
contentTypesFilter
Depuis : 5.2.0 Optional filter that specifies the content types accepted by the dropzone.
filesOnly
Depuis : 5.2.0 Optional. When set to "yes", the dropzone only accepts files and not string data. Defaults to "no"
Use the prefix filter operator to easily accept multiple related content types. For example this filter will accept all image content types: [prefix[image/]]
The list of available deserializers can be seen by using the filter [deserializers[]] in the Filter tab in Advanced Search.
The dropzone widget displays any contained content within the dropzone.
Display
The dropzone widget creates an HTML <div class="tc-dropzone"> to contain its content. During a drag operation the class tc-dragover is added. CSS is used to provide user feedback. For custom styling of this state where a drag is in progress, specify a custom class name with the class attribute and use CSS with the selector .myclass.tc-dragover.
Data types supported
The following data transfer types are supported:
text/vnd.tiddler - a list of tiddlers in JSON format (this format is generated by the LinkWidget)
text/plain - plain text
text/uri-list - a list of URIs as a single tiddler
Depuis : 5.1.23 The slugify operator can be used to transform arbitrary tiddler titles into human readable strings suitable for use in URLs or filenames. However, it is possible for multiple different titles to slugify to the same string. The duplicateslugs operator can be used to display a warning. For example:
<$list filter="[!is[system]duplicateslugs[]limit[1]]" emptyMessage="There are no duplicate slugs">
The following tiddlers have duplicate slugs:
<ul>
<$list filter="[!is[system]duplicateslugs[]]">
<li><$link><$text text=<<currentTiddler>>/></$link></li>
</$list>
</ul>
</$list>
Each input title is processed in turn. The value of field F in the corresponding tiddler is examined.
each
As long as the value of the field is unique (i.e. has not been encountered before), the title is appended to the output.
each:list-item
The value is treated as a title list. Each title in the list considered in turn. If it has not been encountered before, it is appended to the output.
each:value
As long as the title is unique it is appended to the output whether or not the corresponding tiddler exists.
Note that if a tiddler does not contain field F, it is treated as if the value of the field were empty. Thus, a filter expression such as [each[motovun]] will return one tiddler that doesn't have a motovun field, as well as one tiddler with each distinct value of that field, if any. To obtain just the tiddlers that have a non-blank value for the motovun field one can use [each[motovun]has[motovun]].
Each input title is processed in turn. The value of field F in the corresponding tiddler is examined, and as long as this indicates a date that has not been encountered before, the title is appended to the output.
If a tiddler doesn't contain field F, it contributes nothing to the output.
You can see the current settings for the view template body cascade in $:/ControlPanel under the Info -> Advanced -> Cascades -> Edit Template Body tab.
Michael Fogleman a rédigé un mode Emacs majeur appelé tid-mode, qui permet de modifier des fichiers TiddlyWiki .tid. C'est une variante du mode-texte qui utilise les modes mineurs org-struct et subword, et met à jour les modifications à chaque sauvegarde du fichier .tid .
Il a aussi écrit deux fonction aidant à l'utilisation de TiddlyWiki sur Emacs. La première ouvre un dossier de tiddlers dans Dired ; la seconde ouvre TiddlyWiki dans le navigateur.
(defun open-wiki ()
"Opens a TiddlyWiki directory in Dired."
(interactive)
(dired "~/Dropbox/wiki/tiddlers/"))
(defun browse-wiki ()
"Opens TiddlyWiki in the browser."
(interactive)
(browse-url "127.0.0.1:8080/"))
Cette fonction ultérieure nécessite un navigateur spécifique :
TiddlyWiki est publié sous différentes éditions adaptées à des objectifs spécifiques. Chacune est constituée des mêmes composants TiddlyWiki principaux, associés aux plugins nécessaires, à la documentation et au contenu d'exemple.
Vous pouvez mélanger les composants de ces éditions à votre gré pour créer une solution unique pour votre application dédiée.
The editor toolbar is a toolbar that helps you format text easily. It appears above the text input field in a tiddler when in edit mode. It has a similar appearance to desktop text editors like Microsoft Word or Libre Office Write.
What the Editor toolbar does
When you press the button for a function, it will insert the WikiText in the text field. As an example, if you press the bold button it will insert '' ''.
If you highlight a piece of text the markup code will automatically go around the highlighted text.
If you are in another mode, like MarkDown, the toolbar will change to that syntax and insert appropriate code. However It will not change previously typed text or markup.
Besides the standard WikiText formatting, the Editor toolbar has the following buttons:
The edit text widget provides a user interface in the browser for editing text tiddler fields. The editing element is dynamically bound to the underlying tiddler value: changes to the tiddler are instantly reflected, and any edits are instantly propogated.
By default, the edit text widget generates a <textarea> as the HTML editing element when the text field is edited, and a <input type="text"> element otherwise. This behaviour can be overridden with the tag and type attributes.
Content and Attributes
The content of the <$edit-text> widget is ignored.
The field to edit (defaults to text). Takes precedence over the index attribute
index
The index to edit
default
The default text to be provided when the target tiddler doesn't exist
class
A CSS class to be assigned to the generated HTML editing element
placeholder
Placeholder text to be displayed when the edit field is empty
focusPopup
Title of a state tiddler for a popup that is displayed when the editing element has focus
tag
Overrides the generated HTML editing element tag. Use textarea for a multi-line editor
type
Overrides the generated HTML editing element type attribute
size
The size of the input field (in characters)
autoHeight
Either "yes" or "no" to specify whether to automatically resize textarea editors to fit their content (defaults to "yes")
minHeight
Minimum height for automatically resized textarea editors, specified in CSS length units such as "px", "em" or "%"
Notes
One trap to be aware of is that the edit text widget cannot be used to edit a field of the tiddler that contains it. Each keypress results in the tiddler being re-rendered, which loses the cursor position within the text field.
Instead, place the edit text widget in a template that references the tiddler you want to modify.
For example, if you wanted to edit the value of the "myconfig" field of the tiddler "AppSettings", you might do so by creating a separate tiddler "ChangeAppSettings" that contains the following:
The edit widget provides a general purpose interface for editing a tiddler. It dynamically chooses the appropriate widget depending on the type of the tiddler (currently either the EditTextWidget or the EditBitmapWidget).
AndroidChromeEdgeFirefoxInternet ExplorerLinuxMacOperaSafariEnregistrer les modificationsWindows
Cette méthode est utile si, pour une raison ou une autre, vous n'arrivez pas à enregistrer votre TiddlyWiki (si un plugin ou un serveur ne marchent plus). Elle devrait fonctionner sur n'importe quelle plateforme.
Ouvrez la Recherche avancée
Choisissez l'onglet « Filtrer »
Saisissez le code de filtre suivant :
[!is[system]!sort[modified]limit[25]]
Vérifiez la liste des tiddlers
Ajustez le nombre « 25 » dans le filtre pour que tous les tiddlers que vous avez modifiés depuis le dernier enregistrement soient visibles dans la liste
Cliquez sur le bouton [] qui s'affiche à droite de la zone de saisie, et choisissez le format de fichier JSON
Une fenêtre du navigateur va vous demander de choisir un emplacement pour enregistrer un fichier nommé tiddler.json ou, selon votre configuration, juste vous notifier que le fichier va être téléchargé. Cliquez sur Enregistrer.
Le fichier tiddlers.json peut être importé (onglet Outils de la barre latérale) ou glissé-déposé sur la ligne supérieure du déroulé des tiddlers d'un autre TiddlyWiki.
Vous pouvez (dé)sélectionner des tiddlers particuliers.
Allez à l'onglet Outils sur la barre latérale, et cherchez le bouton avec une icône de cadenas
Si le bouton a pour intitulé « affecter un mot de passe », c'est que le wiki en cours n'est pas crypté. Cliquer sur le bouton vous demandera un mot de passe qui sera utilisé pour les prochains enregistrements
Si le bouton est intitulé « résilier le mot de passe », cela signifie que le wiki en cours est déjà crypté. Cliquer sur le bouton supprimera le mot de passe de sorte que les enregistrements suivants ne seront pas cryptés
Si vous voulez vérifier que vos données sont bien cryptées, vous pouvez ouvrir le fichier enregistré dans un éditeur de texte (faites attention de ne pas le modifier !)
Ouvrez le fichier dans votre navigateur. Avant d'afficher le contenu, un mot de passe vous sera demandé.
The encrypt widget renders a filtered list of tiddlers to an encrypted block with the password currently held in the PasswordVault. The encrypted block can subsequently be decrypted by the TiddlyWiki5BootMechanism. See the EncryptionMechanism for more details.
Content and Attributes
The content of the <$encrypt> widget is ignored.
Attribute
Description
filter
Filter defining the tiddlers to be included in the encrypted block. If not specified then all non-system tiddlers are used
Literal filter operands cannot contain square brackets but you can work around the issue by using a variable. Learn more at:SetWidget documentation under the heading "Filtered List Variable Assignment"
<$set name="myList" value="first [[second with a space]] third">
<$list filter="[enlist<myList>]">
...
TiddlyWiki pour Node.js reconnaît les variables d'environnement système ci-dessous pour spécifier une liste de chemins (séparés par des deux-points), où chercher les différents plugins et « éditions » :
TIDDLYWIKI_PLUGIN_PATH — Chemin de recherche pour les plugins ordinaires
TIDDLYWIKI_THEME_PATH — Chemin de recherche pour les thèmes
TIDDLYWIKI_LANGUAGE_PATH — Chemin de recherche pour les langues
TIDDLYWIKI_EDITION_PATH — Chemin de recherche pour les éditions (utilisé par la commande Init).
Ces chemins supplémentaires doivent tous pointer vers des dossiers structurés comme leurs répertoires équivalents de l'arborescence TiddlyWiki5 sous GitHub : les répertoires de plugins, thèmes et langues contiennent publisher/nomduplugin/<fichiers> tandis que les répertoires des « éditions » contiennent nomedition/<fichiers>
Exemple :
TIDDLYWIKI_PLUGIN_PATH=~/MonMagasinDePlugins
tiddlywiki monwiki --build index
This is an advanced widget intended for use by those familiar with HTML, CSS and JavaScript handling of DOM events.
The event catcher widget traps DOM-initiated Javascript events dispatched within its child content, and allows invoking a series of ActionWidgets in response to those events.
In order for the events to be trapped:
The event must be of one of the events specified in the event catcher widget's events attribute
The event must target a DOM node with an ancestor that matches the widget's selector attribute
Depuis : 5.2.2 Optionally, the DOM node targeted by the event must also match the widgets matchSelector attribute
The event must support event bubbling
Use of the event catcher widget is beneficial when using large numbers of other trigger widgets such as the ButtonWidget is causing performance problems. The workflow it enables is akin to what is referred to as "event delegation" in JavaScript parlance.
Content and Attributes
The content of the <$eventcatcher> widget is displayed normally.
Attribute
Description
selector
A CSS selector. Only events originating inside a DOM node with this selector will be trapped
matchSelector
Depuis : 5.2.2 An optional CSS selector. Only events targeting DOM nodes matching this selector will be trapped
{any attributes starting with $}
Depuis : 5.2.0 Each attribute name (excluding the $) specifies the name of an event, and the value specifies the action string to be invoked. For example: $click=<<clickActions>>
tag
Optional. The HTML element the widget creates to capture the events, defaults to: » span when parsed in inline-mode » div when parsed in block-mode
class
Optional. A CSS class name (or names) to be assigned to the widget HTML element
stopPropagation
Depuis : 5.2.0 Optional. Set to "always" to always stop event propagation even if there are no corresponding actions to invoke, "never" to never stop event propagation, or the default value "onaction" with which event propagation is only stopped if there are corresponding actions that are invoked.
events
(deprecated – see below) Space separated list of JavaScript events to be trapped, for example "click" or "click dblclick"
actions-*
(deprecated – see below) Action strings to be invoked when a matching event is trapped. Each event is mapped to an action attribute name of the form actions-event where event represents the type of the event. For example: actions-click or actions-dblclick
Depuis : 5.2.0 Note that the attributes events and actions-* are no longer needed. Instead you can use attributes starting with $ where the attribute name (excluding the $) specifies the name of the event and the value specifies the action string to be invoked. If any attributes with the prefix $ are present then the types attribute is ignored.
Variables
The following variables are made available to the actions:
Variables
Description
dom-*
All DOM attributes of the node matching the given selector are made available as variables, with the prefix dom-
modifier
The modifier Variable contains the Modifier Key held during the event (can be "normal", "ctrl", "shift", "alt" or combinations thereof)
event-mousebutton
The mouse button (if any) used to trigger the event (can be "left", "right" or "middle"). Note that not all event types support the mousebutton property
Any properties in the detail attribute of the event are made available with the prefix event-detail-
tv-popup-coords
A relative co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see Coordinate Systems for more information)
tv-popup-abs-coords
Depuis : 5.2.4 An absolute co-ordinate string that can be used with the ActionPopupWidget to trigger a popup at the DOM node matching the selector where the event originated (see Coordinate Systems for more information)
tv-widgetnode-width
Depuis : 5.2.3offsetWidth of the DOM node created by the eventcatcher widget
tv-widgetnode-height
Depuis : 5.2.3offsetHeight of the DOM node created by the eventcatcher widget
tv-selectednode-posx
x offset position of the selected DOM node
tv-selectednode-posy
y offset position of the selected DOM node
tv-selectednode-width
offsetWidth of the selected DOM node
tv-selectednode-height
offsetHeight of the selected DOM node
event-fromselected-posx
x position of the event relative to the selected DOM node
event-fromselected-posy
y position of the event relative to the selected DOM node
event-fromcatcher-posx
x position of the event relative to the event catcher DOM node
event-fromcatcher-posy
y position of the event relative to the event catcher DOM node
event-fromviewport-posx
Depuis : 5.2.0x position of the event relative to the viewport
event-fromviewport-posy
Depuis : 5.2.0y position of the event relative to the viewport
Example
This example uses the ActionLogWidget and will log the data-item-id attribute of the clicked DOM node to the browser's JavaScriptconsole
\define clickactions()
<$action-log item=<<dom-data-item-id>> event=<<event-type>>/>
\end
\define contextmenu-actions()
<$action-log item=<<dom-data-item-id>> event=<<event-type>>/>
\end
<$eventcatcher selector=".item" $click=<<clickactions>> $contextmenu=<<contextmenu-actions>> tag="div">
<div class="item" data-item-id="item1">
Click events here will be trapped
</div>
<div class="item" data-item-id="item2">
And here too
</div>
<div data-item-id="item3">
Not here
</div>
<div class="item" data-item-id="item4">
And here
</div>
</$eventcatcher>
Depuis : 5.2.4 It is possible to define the toc-open-icon and toc-closed-icon variable, to change the icons used by the toc macros. This setting works for all toc-macro variants
Select a topic in the table of contents. Click the arrow to expand a topic.
<$macrocall
$name="toc-tabbed-external-nav"
tag="TableOfContents"
selectedTiddler="$:/temp/toc/selectedTiddler"
unselectedText="<p>Select a topic in the table of contents. Click the arrow to expand a topic.</p>"
missingText="<p>Missing tiddler.</p>"
/>
Choisir un article dans la table des matières. Cliquer sur la flêche pour le développer.
<$macrocall
$name="toc-tabbed-internal-nav"
tag="TableOfContents"
selectedTiddler="$:/temp/toc/selectedTiddler"
unselectedText="<p>Choisir un article dans la table des matières. Click the arrow to expand a topic.</p>"
missingText="<p>Tiddler manquant.</p>"
/>
Cette compilation montre des exemples intéressants et inspirants d'utilisation de TiddlyWiki qu'on peut trouver dans la nature. Proposez de nouvelles entrées pour cette collection via GitHub, Twitter ou en postant sur les groupes de discussion TiddlyWiki.
This TiddlyWiki, which is still under construction, has several features that together make it lightning fast to find passages, types of passages, themes, people, places and images in the New Testament Gospels. The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
See how the different types of passages are distributed throughout each Gospel.
Hover over passages to see the verses and titles.
Click on a passage to open it and see the themes and other data it mentions.
The themes by passage indexes are lists of the passages in each Gospel, followed by the themes and other data found in the passage. Clicking on a theme calls up a list of all the passages that mention that theme.
The indexes of themes contain lists of links to each theme, person, group, place and image. Clicking on a theme calls up a list of all the passages that mention that theme.
There is a search window hidden in the right hand menu. Use the search window to find passages quickly, by typing things like sower or paralytic. Click the arrows in the upper right of the screen to open the menu and search.
TriTarget.org is a name I came up with in high school. I was big into computer programming and wanted a company name that was kinda catchy. When I made a few programs in BASIC I would brand them with TriTarget as a way to show off my company (Even though I didn't have one).
This document is an attempt to be a fairly comprehensive guide to recovering from what you did not mean to do when using git. It isn't that git is so complicated that you need a large document to take care or your particular problem, it is more that the set of things that you might have done is so large that different techniques are needed depending on exactly what you have done and what you want to have happen.
Un interprète Forth véloce pour le Commodore PET, écrit en langage assembleur 6502. Le TiddlyWiki contenant la documentation du programme est automatiquement engendré à partir du code source : voir https://github.com/chitselb/pettil.
Les objectifs du projet étaient, sans ordre particulier :
faire un interpréteur Forth exécutable sur mon Commodore PET 2001
prendre du plaisir
développer mes compétences en "assembleur 6502"
trouver d'autres personnes intéressées par le projet
Voici un exemple de carnet de thèse réalisé avec TiddlyWiki 5.0.8-beta.
TiddlyWiki est un très beau logiciel de Jeremy Ruston. Il vous permet, entre autres choses, de prendre des notes, de gérer vos idées, de garder des informations, et d'afficher un tas de choses de la façon que vous choisirez. C'est un outil incroyablement malléable que vous pouvez adapter à la plupart de vos besoins.
Ce TiddlyWiki a été personnalisé pour être utilisé comme un carnet de notes sur la philosophie, récapitulant auteurs, ouvrages, articles, concepts, théories, et notes personnelles. Je l'utilise avec Zotero, un logiciel spécialisé de bibliographie. Les deux sont des projets libres et ouverts. TiddlyWiki peut-être téléchargé sur https://tiddlywiki.com.
J'ai développé un logiciel pour assister dans la saisie et la mémorisation des information de planification des cours et ainsi faciliter/automatiser un ennuyeux travail lors de à la création du document actuel de planification des leçons.
Une introduction à la bible d'Obadiah par Dave Gifford utilisant la macro sommaire et différents réglages personnalisés de TiddlyWiki : un bouton nouveau, ici, modifié ajout d'un viewtemplate personnalisé pour intégrer des notes ou des images dans tout tiddler, et un tiddler transcluant tout contenu, adapté pour faciliter l'impression (ce tiddler).
J'ai voulu évaluer la possibilité de créer un certain type de jeu en utilisant seulement le noyau de tiddlywiki sans plugins ou code javascript. J'ai réalisé un jeu de fiction interactif de type zork réduit à l'essentiel. C'est le jeu le plus simple que je puisse faire à ce jour, mais je pourrai faire quelques ajouts à l'avenir. il utiliser la préversion 5.1.5 car le widget action-setfield épargne un gros travail d'élaboration de macros.
Le but était de n'utiliser que les fonctions du noyau de tiddlywiki, aussi il n'y a ni plugins, ni javascript.
The exponential operator returns a string representation of the input number in exponential notation with the specified number of digits. If a number has more digits than requested, the number is rounded to the nearest number represented by the specified number of digits
Le mécanisme d'exportation qui a fait son apparition avec la version 5.1.5 de TiddlyWiki permet de sélectionner facilement un sous-ensemble de tiddlers afin de le sauvegarder dans un fichier.
Si par exemple vous souhaitez sauvegarder dans un fichier tous les tiddlers ayant un tag WikiText et contenant un champ fr-title, entrez le filtre[tag[WikiText]has[fr-title]] dans l'onglet Filtre de la Recherche avancée et choisissez Fichier de tiddlers au format JSON après avoir cliqué sur
Vous obtenez alors un fichier nommé tiddlers.json, qui contient tous les tiddlers sélectionnés et qui pourra être réutilisé plus tard via un simple glissé-déposé sur un TiddlyWiki ouvert.
Some filters are designed to move items from the tail of the list and insert them at specified locations in the list, e.g. putafter or putbefore. Items are often appended to the list before using these filters. In general, these filters accept a suffix specifying the number of items to move (default to 1.)
Some filters are designed to either add or remove from the list, a selected range of items from an array, e.g. append or remove. These filters are best used with a reference to an array, stored in a field or data index elsewhere in the wiki (they may be used with a simple list of items, provided the items do not include white space.) In general, these filters accept a suffix specifying the number of items to move (default to All.)
In this example we shall populate the 'DataIndex' index of the tiddler 'MyData' with the names of the days of the week, then clear this list.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[list[Days of the Week]]"/>
Get days-of-the-week
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[[]]"/>
Clear
</$button>
{{ListopsData}}
Affichera ceci :
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to insert items before and after a marker item (Wednesday) that are first appended to the list.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="one two +[putbefore:2[Wednesday]]"/>
Put 2 Items Before Wednesday
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="four five +[putafter:2[Wednesday]] three +[putbefore[Wednesday]]"/>
Put One Item Before & Two Items After Wednesday
</$button>
{{ListopsData}}
Affichera ceci :
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to replace the marker item (Wednesday) with items which are first appended to the list. We shall then move 3 items to the head of the list which have first been appended to the list from referenced fields.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="[[---o]] [[o---]] +[replace:2{!!marker}]"/>
Replace '!!marker' with 2 Items
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="[{!!item1}] [{!!item2}] [{!!item3}] +[putfirst:3[]]"/>
Put 3 Items First
</$button>
{{ListopsData}}
Affichera ceci :
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to append to the truncated list, items from a referenced field. We shall then remove the first two of the items added.
|list: |<$view field="list"/> |
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[allbefore:include[Wednesday]] +[prepend{!!list}]"/>
Prepend '!!list' to items before 'Wednesday'
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[remove:2{!!list}]"/>
Remove first two items in '!!list' from current list
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[!remove:1{!!list}]"/>
Remove last item in '!!list' from current list
</$button>
{{ListopsData}}
Affichera ceci :
list:
Yesterday Today Tomorrow
DataIndex:
In this example we shall populate the list with numbers, then move items one by one from the head to the tail and from the tail to the head (best seen by clicking the lower buttons several times.)
This example illustrates that the append[] and prepend[] operators do not enforce unique instances of an item and that, with the next run, any duplicates are removed.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[[]]" $subfilter="+[append:3{!!numbers}]"/>
Setup some numbers
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[!append:6{!!numbers}]"/>
Append more numbers
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[putfirst:2[]]"/>
Move last 2 items to the head
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[putlast[]]"/>
Move the head to the last item
</$button>
{{ListopsData}}
The External Attachments Plugin provides support for importing tiddlers as external attachments. That means that instead of importing binary files as self-contained tiddlers, they are imported as "skinny" tiddlers that reference the original file via the _canonical_uri field. This reduces the size of the wiki and thus improves performance. However, it does mean that the wiki is no longer fully self-contained.
This plugin only works when using TiddlyWiki with platforms such as TiddlyDesktop that support the path attribute for imported/dragged files.
Les images externes dans TiddlyWiki sont des tiddlers qui pointent sur l'URI d'une image, plutôt que d'avoir à incorporer toutes les données de l'image. Ils fonctionnent mieux que l'affichage d'images incorporées, notamment avec les images de grande taille. Cependant, leur utilisation détourne TiddlyWiki de sa vocation de fichier unique.
Les images externes sont utilisées dans le navigateur. Elles peuvent être créées soit par la configuration Node.js lors de la production d'un TiddlyWiki, soit manuellement en éditant un TiddlyWiki dans le navigateur .
Qu'est-ce qu'une image externe
Une image externe est un tiddler image ordinaire avec un champ _canonical_uri contenant l'URI de l'image. L'URI pointe de façon absolue ou relative vers le document HTML. Si le champ _canonical_uri est renseigné, alors le champ text du tiddler est ignoré et peut être omis.
Création manuelle d'Images Externes
Pour créer manuellement une image externe, il suffit juste de créer un tiddler avec le type de contenu image approprié, puis d'ajouter un champ _canonical_uri dont l'URI pointe vers l'emplacement de stockage de l'image.
IMPORTANT : Revérifiez votre orthographe. _canonical_uri s'épelle URI, et pas URL.
Création d'images externes sous Node.js
Suivre les étapes suivantes pour créer une version HTML statique d'un fichier wiki accompagné d'un dossier images contenant les références des images externes :
Créer des Tiddlers image dans votre TiddlyWikiFolders de façon habituelle
Sauvegardez les images en fichiers séparées (par convention, dans le sous-répertoire nommé images)
Externalisez les Tiddlers image en leur attribuant un champ _canonical_uri
Sauvegardez le fichier HTML principal
Notez que les fichiers images doivent être sauvegardés avant d'être externalisés. Leur externalisation écrasera les champs text de la mémoire de votre wiki, ce qui signifie que toute tentative de sauvegarde échouera.
Pour un exemple, voir la génération de la cible externalimages dans la demo tw5.com wiki :
La commande --savetiddlers suivante peut être utilisée pour sauvegarder les images d'un wiki dans un sous-répertoire images :
--savetiddlers [is[image]] images
Externalisez les Tiddlers Image
Deux commandes --setfield sont utilisées : la première affecte au champ _canonical_uri l'URI correspondant au titre du tiddler, et la deuxième efface le champ text.
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plain
<!--
This template is used to assign the ''_canonical_uri'' field to external images.
Change the `./images/` part to a different base URI. The URI can be relative or absolute.
-->
./images/<$view field="title" format="doubleurlencoded"/>
Notez que ces opérations modifient les tiddlers dans la mémoire du wiki et peuvent donc affecter le fonctionnement de commandes ultérieures.
Utilisation d'Images Externes
Vous ne pouvez pas éditer une image externe directement dans le navigateur, sauf en changeant le champ URI pour pointer vers une image différente.
A favorite item also called a bookmark is a shortcut, you are creating for quick access to it. You can access that bookmark at any time and view that as many times as you want without having to search and find it again.
The Favorites plugin contains three modes
flat mode: one favorite list, no folder
structured mode: use folder, search tool, export and delete tool
frozen list: read only, simple table of content style
Federatial Limited est une entreprise de consultants en logiciel fondée par JeremyRuston, le créateur de TiddlyWiki.
Federatial aide les organisations à explorer de nouveaux concepts d'interaction utilisateur grâce au prototypage rapide d'outils sophistiqués basés sur le web.
Federatial Limited est une entreprise de consulting fondée par JeremyRuston et spécialisée dans la compréhension des impacts du web sur le travail collaboratif.
Télécharge un ou plusieurs fichiers via HTTP/HTTPS, puis importe les tiddlers correspondant à un filtre, en transformant optionnellement les titres des tiddlers importés.
Avec la variante "file", un seul fichier est téléchargé et le premier paramètre est l'URL du fichier à lire.
Avec la variante "files", plusieurs fichiers sont téléchargés et le premier paramètre est un filtre produisant une liste d'URLs pour les fichiers à lire. Par exemple, étant donné un ensemble de tiddlers tagués "remote-server" et disposant d'un champ "url", le filtre [tag[remote-server]get[url]] permet de récupérer toutes les URLs disponibles.
Le paramètre <filtre-import> spécifie un filtre qui détermine quels tiddlers seront importés. Lorsqu'il n'est pas indiqué, il prend comme valeur par défaut [all[tiddlers]].
Le paramètre <filtre de transformation> spécifie un filtre optionnel qui transforme les titres des tiddlers importés. Par exemple, [addprefix[$:/myimports/]] permettrait d'ajouter le préfixe $:/myimports/ à chaque titre.
On obtient des informations concernant la progression de l'importation en faisant précéder la commande --fetch de la commande --verbose.
Il faut noter que TiddlyWiki ne téléchargera pas une version plus ancienne d'un plugin déjà chargé.
L'exemple ci-dessous récupère tous les tiddlers non-système de https://tiddlywiki.com et les enregistre dans un fichier JSON :
<$fieldmangler>
Add tag ''example'' to this tiddler (current)<$button message="tm-add-tag" param="example">{{$:/core/images/new-button}}</$button>
<br>
Remove tag ''example'' to this tiddler (current)<$button message="tm-remove-tag" param="example">{{$:/core/images/delete-button}}</$button>
</$fieldmangler>
<$fieldmangler tiddler="Hello World">
Add tag ''example'' to the Hello World tiddler<$button message="tm-add-tag" param="example">{{$:/core/images/new-button}}</$button>
<br>
Remove tag ''example'' to the Hello World tiddler<$button message="tm-remove-tag" param="example">{{$:/core/images/delete-button}}</$button>
</$fieldmangler>
Each input title is processed in turn. Its list of field names is retrieved (in no particular order) and then dominantly appended to the operator's output.
Depuis : 5.1.22 If the include suffix is used, fields are only included, if they exist. It doesn't matter, if fields have a value. The exclude suffix is there for convenience, since it would be possible to use a second filter run. For more info see the examples.
The fields widget renders each field of a specified tiddler through a simple text template. A list of fields to exclude can be provided. It is used internally by TiddlyWiki5, notably by the FileSavingMechanism.
Template Handling
The provided template is rendered with the following special substitutions:
Symbol
Substitution
$name$
Field name
$value$
Field value
$encoded_value$
HTML encoded form of field value
Content and Attributes
The content of the <$fields> widget is ignored.
Attribute
Description
tiddler
Title of the tiddler from which the fields are to be displayed (defaults to the current tiddler)
template
Text of the template (see above)
exclude
Lists of fields to be excluded (defaults to "text")
include
Lists of fields to be included, if the field exists. This parameter takes precedence over "exclude"
sort
Sorts the fields by name (defaults to "yes"). Set to "no", if "include" order should be retained!
sortReverse
Reverses the sort order
stripTitlePrefix
If set to "yes" then curly bracketed prefixes are removed from titles (for example {prefix}HelloThere converts to HelloThere)
The stripTitlePrefix attribute is used when building TiddlyWiki Classic; see editions/tw2 in the TiddlyWiki5 repo.
Depuis : 5.3.0 The $fill widget is used within a $transclude widget to specify the content that should be copied to the named "slot". Slots are defined by the $slot widget within the transcluded content.
See the $transclude widget for details and an example. More examples can be found in the $slot widget documentation.
Attributes
The content of the $fill widget is used as the content to be passed to the transclusion.
Attribute
Description
$name
The name of the slot to be filled
The $name attribute must be specified as a literal string
L'expression d'un filtre est le plus haut niveau de la syntaxe d'un filtre.Elle est composée d'une ou plusieurs séquences.
Une entrée de séquence est souvent une liste de tous les titres des tiddlers non-shadow du wiki (sans tri particulier). Mais le préfixe + peut modifier cela.
Si une séquence ne comporte pas de préfixe + ou -, ces titres en sortie sont ajoutés par prépondérance au résultat du filtre.
Si une séquence comporte un préfixe -, les titres en sortie sont extraits du résultat du filtre (s'ils y étaient).
Si une séquence comporte un préfixe +, elle compare les sorties du filtre à ses entrées. La sortie du filtre est alors entièrement remplacée par les séquences qui se recoupent. Toutes séquences de titres de tiddler suivantes sont traitées comme des entrées, à moins qu'elles n'aient aussi un préfixe +.
remove every input title for which the filter run output is an empty list
input
all titles from previous filter runs
output
the input titles for which the filter run is not empty
It receives the filter output so far as its input. The next run is evaluated for each title of the input, removing every input title for which the output is an empty list.
Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like :filter[{!!price}multiply{!!cost}compare:integer:gteq[5]] to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
The following variables are available within the filter run:
currentTiddler - the input title
..currentTiddler - the value of the variable currentTiddler outside the filter run.
index - Depuis : 5.2.1 the numeric index of the current list item (with zero being the first item in the list).
revIndex - Depuis : 5.2.1 the reverse numeric index of the current list item (with zero being the last item in the list).
length - Depuis : 5.2.1 the total length of the input list.
Compare named filter run prefix :filter with filter Operator which applies a subfilter to every input title, removing the titles that return an empty result from the subfilter
Comparison between :filter and :and/+ filter run prefixes
The functionality of the :filter filter run prefix has some overlap with the :and prefix (alias +). Notice the filter expressions above all have the following two properties:
The start of the filter expression transforms the input titles (i.e. get[text]length[], links[], <index>remainder[2], {!!quantity}.
The end of the filter expression only sends input items to the output if they meet some condition (i.e. compare, is).
The purpose of the :filter prefix is to return the original input titles despite property #1 causing those input titles to be transformed. That way, the "meet some condition" check can be performed on something other than the original input. If some filter expression does not require property #1, then the :and prefix can be used instead.
Depuis : 5.1.23 The filter operator runs a subfilter for each input title, and returns those input titles for which the subfilter returns a non-empty result (in other words the result is not an empty list). The results of the subfilter are thrown away.
Simple filter operations can be concatenated together directly (eg [tag[HelloThere]search[po]]) but this doesn't work when the filtering operations require intermediate results to be computed. The filter operator can be used to filter on an intermediate result which is discarded. To take the same example but to also filter by those tiddlers whose text field is longer than 1000 characters:
Note that within the subfilter, the "currentTiddler" variable is set to the title of the tiddler being processed. The value of currentTiddler outside the subfilter is available in the variable "..currentTiddler". Depuis : 5.2.0
Compare with the similar subfilter operator which runs a subfilter and directly returns the results
Compare with the analogous named filter run prefix :filter
Un opérateur de filtre est un motclé prédéfini attaché à une étape individuelle d'un filtre. Il définit une action particulière de cette étape.
Le tableau suivant liste tous les opérateurs du noyau. Les plus communs sont côchés. La troisième colonne indique quels opérateurs acceptent le ! préfixe pour inverser leur expression.
applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved. With a single parameter, the default field is "text" and the default index is "0". If a second parameter is provided, that becomes the target field or index.
Le paramètre est le texte exact tel qu'il apparait entre les crochets.
souple
indirect
{comme ceci}
Le paramètre est le texte mentionné par la Référence Textuelle dont le nom apparaît entre les accolades, c'est à dire un champ d'un tiddler spécifique, ou la valeur d'une propriété d'un tiddler de données.
variable
<comme ceci>
Le paramètre est la valeur actuelle de la variable dont le nom apparaît entre les chevrons. Les paramètres Macro ne sont pas supportés.
Les étapes sont traitées de gauche à droite. Ce qui entre dans la première étape correspond à ce qui entre dans la séquence. Pour chaque étape suivante, l'entrée provient de la sortie de l'étape précédente.
La plupart des opérateurs forment leurs résultats à partir de leurs entrées. Par exemple, la plupart produisent un sous-ensemble de leur entrée, et se faisant, méritent vraiment leur nom de "filtres",car ils réduisent la taille du résultat généré par la séquence. Ces opérateurs sont nommés modifieurs de sélection.
Quelques opérateurs ignorent leurs entrées et génèrent un résultat indépendant. Ils sont appelés constructeurs de sélection : Ils construisent une sélection entièrement nouvelle.
Un bon exemple de constructeur est l'opérateur title. Le résultat de [title[A]title[B]] est juste B. Mais l'ajout de l'opérateur modifieur field, [title[A]field:title[B] ne produit plus rien du tout.
Les trois options basses du diagramme correspondent aux syntaxes SalutàTous, "SalutàTous", 'SalutàTous' et "Opérateurs de Filtre". Ce sont des abrégés de [title[...]].
Les options cotées existent pour tenir compte des titres contenant des crochets, comme, "Un Tiddler [[[[Peucourant]]]]".
Une étape correspond à une opération unique au sein d'un filtre.
En termes de développement, cela s'apparente à l'appel d'une fonction où l'entrée d'une étape est passée comme un paramètre implicite. La sortie d'une étape est une sélection qui contribue à former une séquence et donc aussi à l'expression du filtre entière qui la contient.
L'opérateur d'étape est issu d'une liste de motsclés prédéfinis, et qui peut être étendue par des plugins. Tout opérateur inconnu est traité comme s'il était le suffixe de l'opérateur field. Si un opérateur d'étape est omis, sa valeur par défaut est title.
Le suffixe est un texte additionnel, souvent le nom d'un field, qui étend la signification de certains opérateurs.
Plusieurs étapes requièrent une valeur de paramètre explicite, aussi connue sous le nom d'opérande, qui définit ce que l'étape doit faire.
Les Filtres suivent une grammaire représentée ici par des diagrammes en chemin de fer, pour ceux qui trouvent utile une description formelle de la syntaxe. Cependant, vous pouvez apprendre à écrire des filtres sans avoir besoin de comprendre ces tiddlers modèle de description.
Un filtre est un tube qui transforme une entrée en sortie. Les entrées et les sorties sont des ensembles ordonnés de titres de tiddlers ou de champs.
Les Filtres sont des expressions construites à partir de plus petits blocs, appelés séquences ou étapes, chacun d'entre eux transformant une entrée en sortie.
Un filtre débute avec un sortie vide. Il s'exécute de gauche à droite, puis progressivement modifie et compose la sortie finale.
Ci-dessous, les détails des différents blocs de construction impliqués :
Filtered attribute values are indicated with triple curly braces around a Filter Expression. The value will be the first item in the resulting list, or the empty string if the list is empty.
Depuis : 5.2.2 To improve readability, newlines can be included anywhere that whitespace is allowed within filtered attributes.
This example shows how to add a prefix to a value:
Un opérateur de filtre est un motclé prédéfini attaché à une étape individuelle d'un filtre. Il définit une action particulière de cette étape.
Le tableau suivant liste tous les opérateurs du noyau. Les plus communs sont côchés. La troisième colonne indique quels opérateurs acceptent le ! préfixe pour inverser leur expression.
applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved. With a single parameter, the default field is "text" and the default index is "0". If a second parameter is provided, that becomes the target field or index.
Vous pouvez vous représenter TiddlyWiki comme une base de données où tous les enregistrements sont des tiddlers. Une base de données propose typiquement un moyen de découvrir quels enregistrements satisfont à des critères donnés, avec TiddlyWiki c'est effectué par les filtres.
Un filtre est une notation notation concise pour sélectionner un ensemble de tiddlers particuliers, envoyé dans une output. Quand TiddlyWiki rencontre un filtre, il calcule l'output (la sortie). D'autres tâches peuvent être réalisées avec ces tiddlers, comme le dénombrement ou leur listage.
L'exemple qui suit envoie la sortie d'un filtre à la macro list-links pour afficher la liste des tiddlers qui commencent par la lettre H :
<<list-links "[prefix[H]]">>
La sortie d'un filtre peut changer selon que des tiddlers sont ajoutés ou supprimés du wiki. TiddlyWiki recalcule à la volée, actualisant automatiquement aussi bien les dénombrements basés sur des filtres que les listages.
La Recherche Avancée a un onglet Filtrer qui facilite l'expérimentation et l'apprentissage des filtres.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
The fixed operator returns a string representation of the input number that does not use exponential notation and has exactly the specified number of digits after the decimal place. The number is rounded if necessary, and the fractional part is padded with zeros if necessary so that it has the specified length.
The suffix B is one of the following supported string formats:
Format
Description
date
The input string is interpreted as a UTC date and displayed according to the DateFormat specified in the optional operator operand. (Defaults to "YYYY MM DD 0hh:0mm")
json
Depuis : 5.2.4 The input string is interpreted as JSON and displayed with standard formatting. The optional operator operand specifies the number of spaces to use for indenting, or a string to use for indenting. Nothing is returned if the input string is not valid JSON
relativedate
The input string is interpreted as a UTC date and displayed as the interval from the present instant. Any operator parameters are ignored
timestamp
Depuis : 5.3.0 The input string is interpreted as number of milliseconds since the ECMAScript epoch, 1 January 1970, and displayed according to the DateFormat specified in the optional operator operand. (Defaults to "[UTC]YYYY0MM0DD0hh0mm0ss0XXX")
titlelist
Depuis : 5.2.0 The input string wrapped in double square brackets if it contains a space. Appropriate for use in a title list.
Invalid input strings are dropped by the format operator.
The Title List format cannot reliably represent items that contain certain specific character sequences such as ]] . Thus it should not be used where there is a possibility of such sequences occurring.
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns instead of just one straight listing. The following method creates an actual table structure and uses the nth operator to provide break points for the rows. It is not responsive, that is, it doesn't re-position to display fewer columns if the window is too small.
In the first, outer list structure you must provide a count to indicate at item number rows should occur. So, in the following example, each row breaks after 4 items, so the sequence is 1,5,9, etc. Note that this requires you to know in advance the maximum number of items there will be. There is also an internal limit that is set to n-1 items, where n is the number of columns you want.
Note also that you need to repeat the driving filter operator inside of the internal <$list> widget. Obviously this technique lends itself to a macro implementation.
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns, instead of just one straight listing. This method uses ~CSS to set up listing as columns and assumes that you know how many columns you want. The method here is to create a style that reflects the number of columns you want your table to be in, and then apply that style to the resulting list output.
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns, instead of just one straight listing. This method uses CSS to set up listing as columns. It is responsive, that is, re-positioning to display fewer columns if the window is too small.
You don't directly specify a fixed number of columns but instead specify the max-width for the list (which could be a transclusion of the tiddler width) and the width for each item. It lists from left to right, then wraps to a new row.
Au sein d'un tiddler, vous pouvez utiliser un formatage spécifique appelé WikiText, afin de contrôler la manière dont le texte sera affiché.
Formatage simple
Dans sa plus simple expression, WikiText vous permet d'appliquer des fonctions de traitement de texte familières comme le gras, l'italique, les listes et les tableaux. Par exemple :
Portez ce //vieux// whisky au ''juge'' ~~brun~~ blond qui `fume`
Les fonctionnalités avancées de WikiText permettent de produire des listes automatisées et des fonctions interactives comme des menus déroulants. En fait, toute l'interface de TiddlyWiki est elle-même écrite en WikiText ; autrement dit, toutes les fonctionnalités que vous voyez dans TiddlyWiki peuvent être adaptées pour être utilisées dans vos propres wikis.
Certaines fonctionnalités avancées nécessitent un codage complexe. TiddlyWiki inclut plusieurs macros prédéfinies, qui simplifient les fonctions usuelles d'interface utilisateur, comme les onglets, les tables des matières, et les listes de tiddlers.
En savoir plus
Voir WikiText pour une introduction détaillée à l'écriture de WikiText.
Le nouveau forum officiel pour discuter de TiddlyWiki : demandes d'aide, annonces de nouvelles version et plugins, échanges sur les nouvelles fonctionnalités, ou simples partages d'expériences. Vous pouvez participer via le site web associé, ou souscrire par email.
Notez que talk.tiddlywiki.org est un service communautaire que nous hébergeons et maintenons nous-mêmes. Les modestes frais de mise à disposition du site sont couverts par les contributions de la communauté.
Pour le confort de la communauté, l'ancien groupe TiddlyWiki, hébergé sur Google Groups depuis 2005, reste fonctionnel.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
L'édition « complète » de TiddlyWiki intègre toutes les langues, thèmes et plugins disponible de la distribution officielle de TiddlyWiki. Elle est destinée aux tests de TiddlyWiki — et notamment, pour basculer entre tous les plugins linguistiques disponibles.
Provides an alternative search result list that orders results by search relevance and ignores differences in word forms (ex. tag vs tags).
On my personal wiki, I have the problem that there are terms I use across a lot of tiddlers, and sometimes I'll use different forms (such as the aforementioned tag vs tags). I wanted a plugin to allow me to find the tiddler I'm looking for quickly and didn't require me to worry about how I declined a noun or inflected a verb - so I wrote this plugin, which provides an alternative search list powered by lunr.js.
Depuis : 5.3.0 The function operator applies a named function to the input titles, and returns the results from the function. The function is invoked once with all of the input titles (in contrast, the filter Operator invokes its function separately for each input title).
The first parameter of the function operator specifies the name of the function to be called. Subsequent parameters are passed to the function.
The mapping between the parameters is positional, with each consecutive parameter specified in the function call mapped to the corresponding parameter in the function definition. Any parameters that are not provided are given their default values.
Compare with the similar filter and subfilter operators which take a filter strings as their parameter instead of a named function, and does not permit parameters to be passed
Depuis : 5.3.0 A function is a named snippet of text containing a Filter Expression. Functions can have named parameters which are available within the function as variables.
Directly transclude functions with the syntax <<myfn param:"value">>
Assign functions to widget attributes with the syntax <div class=<<myfn param:"value">>>
Invoke functions via the function Operator with the syntax [function[myfn],[value],...]
Directly invoke functions whose names contain a period as custom filter operators with the syntax [my.fn[value]] or [.myfn[value]]
How Functions Work
Functions are implemented as a special kind of variable. The only thing that distinguishes them from ordinary variables is the way that the parameters are handled.
TiddlyWiki is more useful to everybody if it is free to use, with no financial barriers to long term adoption. It is not altruism; we believe that removing or reducing barriers to adoption will help to ensure TiddlyWiki's future by making the community larger and stronger.
Nonetheless, TiddlyWiki is a relatively big, complex machine that requires a significant amount of ongoing work to maintain and improve. Some community infrastructure also requires monthly fees to operate (notably the TiddlyWiki forum).
The people in the community that do the work have widely varying needs:
At one end, a good proportion of the work on TiddlyWiki is performed by community members on a purely voluntary basis. For those people, the satisfaction of helping others is sufficient reward. Indeed, for many people, unpaid voluntary activities are a satisfying antidote to everyday paid work
At the other extreme, JeremyRuston and some other contributors are trying to make a full-time living working on TiddlyWiki by offering commercial products and services around it
In between, there are other people who would appreciate an ocassional token to reward them for their work
To support these needs in the community, we have two initiatives:
We use Open Collective to collect donations for the infrastructure costs of the Community and to crowdfund specific developments by individuals or organisations
The TiddlyWiki Marketplace provides a shop window for individuals and organisations offering commercial products and services
À présent que TiddlyWiki5 a enfin quitté son statut de « beta », j'ai bon espoir qu'il vivra longtemps. Comme il n'utilise que des fonctionnalités standard de HTML5 et Node.js, il n'y a aucune raison pour qu'il ne reste pas entièrement opérationnel dans les années qui viennent. Mon but est qu'il survive au moins 25 ans.
TiddlyWiki a été conçu avec le besoin à long terme des utilisateurs à l'esprit. Comme il est OpenSource et ne nécessite pas d'infrastructure, nous pouvons être sûrs que tout ce dont nous aurons besoin pour accéder à un fichier TiddlyWiki même dans un futur éloigné est un simple navigateur HTML. Si vous commencez à utiliser TiddlyWiki au début de votre carrière, vous pouvez être certain qu'il vous accompagnera jusqu'à la retraite.
There is much flexibility in how the static HTML is generated. The following scenarios are all illustrated on https://tiddlywiki.com.
Wiki Snapshots and Tiddler Snapshots
You can explore a static representation of the main TiddlyWiki site at https://tiddlywiki.com/static.html. That file is a static snapshot of the current DefaultTiddlers. Any tiddlers that it links to are referred to via URLs of the form /static/HelloThere.html that point to static snapshots of individual tiddlers. The tiddler HTML files reference a static.css stylesheet file.
The following commands are used to generate the sample static version of the TiddlyWiki5 site:
It is also possible to produce a single HTML file that contains static representations of tiddlers, and uses standard HTML anchor links to jump between them.
Depuis : 5.2.4 The $genesis widget allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance.
Content and Attributes
The content of the $genesis widget is used as the content of the dynamically created widget.
Attribute
Description
$type
The type of widget or element to create (an initial $ indicates a widget, otherwise an HTML element will be created)
$names
An optional filter evaluating to the names of a list of attributes to be applied to the widget
$values
An optional filter evaluating to the values corresponding to the list of names specified in $names
$mode
An optional override of the parsing mode. May be "inline" or "block"
{other attributes starting with $}
Other attributes starting with a single dollar sign are reserved for future use
{attributes starting with $$}
Attributes starting with two dollar signs are applied as attributes to the output widget, but with the attribute name changed to use a single dollar sign
{attributes not starting with $}
Any other attributes that do not start with a dollar are applied as attributes to the output widget or HTML Element
Depuis : 5.2.6 If the $type attribute is missing or blank, the $genesis widget does not render an intrinsic element, instead just rendering its children.
Note that attributes explicitly specified take precedence over attributes with the same name specified in the $names filter.
\define my-banner(mode:"inline",caption)
<$genesis $type={{{ [<__mode__>match[inline]then[span]else[div]] }}} class="tc-mybanner">
<<__caption__>>
</$genesis>
\end
<<my-banner caption:"I'm in a SPAN">>
<<my-banner mode:"block" caption:"I'm in a DIV">>
Affichera ceci :
I'm in a SPAN
I'm in a DIV
Code HTML correspondant :
<p><span class="tc-mybanner">
I'm in a SPAN
</span></p><p><div class="tc-mybanner">
I'm in a DIV
</div></p>
Important
In the following example the widget attribute named one is not present in the HTML output. This is because HTML attributes starting with the prefix on are removed for security reasons. See HTML in WikiText "Security" for more details. This restriction only affects generated HTML elements, and does not prevent the use of attributes prefixed on with other widgets
Each input title is processed in turn. If the corresponding tiddler contains field F, and the value of this field is not empty, then its value is appended to the output.
Unlike most other Filter Operators, the selection output by get can contain duplicates. To avoid duplicates, use get[F]unique[].
The above example works by first checking if the input title has the field myfield and then using the Map Filter Run Prefix to replace the title with their value of that field. If the input tiddler does not have the field, an empty selection is returned. The subsequent Map Filter Run Prefix outputs an empty string when its run returns an empty selection (because the field is empty).
→ return all tiddlers that are older than HelloThere
The above example demonstrates two different ways of accessing field values in filters: Use get when the title is not known in advance as with the Filter Filter Run Prefix where currentTiddler is set to the current input title. Use a TextReference as an indirect Filter Parameter when the title is known.
Each input title is processed in turn, and is ignored if it does not denote a data tiddler. If the corresponding tiddler contains property P, and the value of this property is not empty, then its value is appended to the output.
Unlike most other Filter Operators, the selection output by getindex can contain duplicates. To avoid duplicates, use getindex[P]unique[].
The above example works by first checking if the input title has the property DataIndex and then using the Map Filter Run Prefix to replace the title with their value of that property. If the input tiddler does not have the property, an empty selection is returned. The subsequent Map Filter Run Prefix outputs an empty string when its run returns an empty selection (because the property is empty).
Téléchargez un TiddlyWiki vide en cliquant sur ce bouton :
L'étape suivante consiste à choisir une solution d'enregistrement des modifications. De nombreuses méthodes sont disponibles, chacune avec ses atouts et ses limites. Cliquez sur la fiche d'une méthode pour voir plus d'informations la concernant. Vous pouvez aussi cocher une case de plateformes et de navigateur pour afficher les solutions qui fonctionnent pour cette combinaison.
N'utilisez pas le menu Fichier/Enregistrer du navigateur internet pour enregistrer vos modifications (ça ne marche pas) !
Méthodes disponibles pour enregistrer les modifications avec TiddlyWiki :
(pour enregistrer le lien, assurez-vous d'avoir installé l'extension "save-link-menus", appuyez quelques secondes sur le lien, puis choisissez "Save link")
Une fois le fichier téléchargé, cliquez dessus depuis la zone de notification ou l'application de gestion des téléchargements
Choisissez d'ouvrir le fichier avec Firefox (et non l'application par défaut proposée par Android)
Cliquez OK en réponse à la demande de TiddlyFox qui vous demande s'il faut activer l'enregistrement pour ce fichier
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
L'application AndTidWiki
Les applications Tiddloid et Tiddloid Lite sont des applis Android qui permettent d'éditer des wikis et d'enregistrer les changements au format HTML de TiddlyWiki.
Créez des nouveaux wikis à partir de la dernière version de TiddlyWiki publiée sur internet
Importez des TiddlyWiki existants stockés sur la mémoire interne de l'appareil. (TiddloidLite permet aussi le stockage sur carte SD externe)
Copiez et personnalisez des TiddlyWiki intéressants à partir d'internet (fonctionne avec TW5 uniquement)
Détection de TiddlyWiki
Les TiddlyWiki stockés localement sont mis à jour en même temps que l'enregistrement des modifications dans les TiddlyWiki importés dans l'appli.
Système de sauvegarde compatible avec celui de TiddlyDesktop
Raccourcis vers vos wikis sur la page d'accueil d'Android
TiddloidLite est compatible avec le stockage en nuage comme GDrive ou OneDrive.
Notes
Tiddloid Lite fonctionne mieux sur les appareils munis d'Android Q ou ultérieur. Il permet aussi le stockage en nuage dans GDrive ou OneDrive, alors que Tiddloid conserve la compatibilité avec TiddlyWiki Classic. Pour en apprendre plus sur les différences entre Tiddloid et Tiddloid Lite, consultez la page d'accueil de Tiddloid.
Pour que l'importation fonctionne correctement, conservez l'extension .html ou .htm de vos fichiers TiddlyWiki.
Sous Google Chrome, TiddlyWiki ne parvient à sauvegarder les modifications qu'à l'aide de la solution de repli standard : le module de sauvegarde compatible HTML5.
Cette manière d'enregistrer les modifications est assez pénible, car elle requiert une intervention manuelle à chaque enregistrement. Elle a l'avantage de fonctionner avec pratiquement tous les navigateurs tournant sur les ordinateurs de bureaux, et de nombreux navigateurs tournant sur appareils mobiles.
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
Localisez le fichier que vous venez de télécharger
Vous pouvez le renommer, mais assurez-vous de conserver l'extension .html ou .htm
Ouvrez le fichier dans votre navigateur
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
Votre navigateur téléchargera alors un nouvel exemplaire du wiki, avec vos modifications à l'intérieur
Localisez ce nouveau fichier et ouvrez-le dans votre navigateur
Vérifiez que vos modifications ont correctement été enregistrées
Truc: la plupart des navigateurs peuvent être configurés pour proposer un chemin d'enregistrement à chaque téléchargement. Cela vous permet de sélectionner la version précédente du fichier et ainsi de la remplacer.
Assurez-vous d'avoir une version de Firefox antérieure à 57. TiddlyFox ne fonctionne plus sur les versions 57 et ultérieures. Pour Firefox 57 et au-delà, pensez plutôt à utiliser :
Si vous utilisez TiddlyFox v1.x.x, cliquez OK en réponse à la demande de TiddlyFox d'activer l'enregistrement pour ce fichier
Si vous utilisez TiddlyFox v2.x.x cliquez sur l’icône de chat sur un globe bleu pour activer l'enregistrement. Il n'y a pas de demande en v2.0.1.
Pour TiddlyFox v2.0.1, vous ne pouvez pas utiliser le mode Navigation Privée, ni activer l'option « Ne jamais conserver l'historique ».
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
Localisez le fichier que vous venez de télécharger
Vous pouvez le renommer, mais assurez-vous de conserver l'extension .html ou .htm
Ouvrez le fichier dans Internet Explorer
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale. Internet Explorer vous demandera votre assentiment pour enregistrer le fichier localement en vous présentant un dialogue Enregistrer sous....
Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement sauvegardées.
Le hack Windows HTA décrit une autre manière d'utiliser TiddlyWiki avec Internet Explorer.
L'application Quine 2 pour iPad/iPhone permet d'éditer et d'enregistrer les modifications de wikis TiddlyWiki5 sur iOS. Vous pouvez la télécharger ici.
Instructions d'utilisation :
Ouvrez Quine 2
Tapez sur le bouton + de la barre d'outils pour créer et ouvrir un nouveau TiddlyWiki
Dans la liste des fichiers tapez sur un fichier TiddlyWiki existant pour l'ouvrir
Éditez le TiddlyWiki comme d'habitude, et enregistrez-le normalement avec Autosave ou le bouton enregistrer
Utilisez le bouton de barre d'outil Documents à gauche pour fermer un TiddlyWiki ouvert
Quine 2 fonctionne nativement sous iOS avec des fichiers locaux ou stockés dans iCloud
Quine 2 permet aussi d'ouvrir, modifier et enregistrer des fichiers TiddlyWiki stockés chez d'autres fournisseurs de service Cloud
Quine 2 permet de suivre des liens Wikitexte embarqués ou des liens canoniques externes vers des fichiers accessibles comme sur le Cloud via des services compatibles avec le folder level sharing
Parmi les applications compatibles, citons Secure Shellfish et Working Copy. La plupart des services ne permet toutefois pas aux applis comme Quine 2 d'utiliser ce type de liens
Si vous voulez activer cette fonctionnalité pour les services « collaboratifs », basculez le commutateur Autoriser la sélection de dossiers pour les liens hors bac-à-sable dans les paramètres iOS de Quine 2
Notez que Quine 2 est publié indépendamment de TiddlyWiki
Ouvrez un terminal de ligne de commande et saisissez :
npm install -g tiddlywiki
En cas d'erreur, il faudra peut-être relancer la commande en tant qu'administrateur :
sudo npm install -g tiddlywiki (Mac/Linux)
Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version
En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple 5.3.2-prerelease ; d'autres informations de débogage peuvent aussi apparaître).
Faites l'essai :
tiddlywiki monnouveauwiki --init server pour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveur
tiddlywiki monnouveauwiki --listen pour démarrer TiddlyWiki
Cliquez sur le bouton Enregistrer les modifications de la barre latérale, OU
tiddlywiki monnouveauwiki --build index
L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki sera disponible seulement dans le répertoire où vous l'avez installé.
Si vous utilisez Debian ou une distribution Linux dérivée de Debian et que vous recevez une erreur node: command not found alors que le paquet node.js est installé, vous devrez peut-être créer un lien symbolique entre nodejs et node. Consultez le manuel de votre distribution et de whereis pour créer un lien correctement. Voir le rapport d'erreur 1434 sur github.
Exemple pour Debian 8.0 : sudo ln -s /usr/bin/nodejs /usr/bin/node
Vous pouvez aussi installer d'anciennes versions de TiddlyWiki ainsi :
Sous Safari, TiddlyWiki ne parvient à sauvegarder les modifications qu'à l'aide de la solution de repli standard : le module de sauvegarde compatible HTML5.
Depuis : 5.1.20 The usual way to retrieve a variable value within a filter is with the angle brackets notation. For example, [<currentTiddler>] will retrieve the value of the variable called currentTiddler.
The getvariable filter operator provides an alternative way to retrieve a variable. For example, [[currentTiddler]getvariable[]] is another way to retrieve the value of the variable currentTiddler.
The advantage of getvariable is that it makes it possible to work with variables whose name is computed, and not known in advance. For example, [<myvariable>getvariable[]] gets the value of the variable whose name is given in the variable myvariable.
Git (/ɡɪt/) is a distributed version control system that tracks changes in any set of computer files, usually used for coordinating work among programmers collaboratively developing source code during software development. Its goals include speed, data integrity, and support for distributed, non-linear workflows (thousands of parallel branches running on different computers).
This instruction is based on Tiddlywiki single html file model, while it can use subfolder for extra materials like images, audios, videos, pdfs,... in separate folders.
This instruction is based on local edit, save and push to GitHub. It does NOT use the new GitHub Saver mechanism (requires TW 5.1.20+) which lets edit and save directly from Tiddlywiki!
GitLab Inc. is an open-core company that operates GitLab, a DevOps software package which can develop, secure, and operate software. The open source software project was created by Ukrainian developer Dmytro Zaporozhets and Dutch developer Sytse Sijbrandij
Les onglets suivants du menu latéral offrent un exemple de listes groupées créées par imbrication.
Option 'types' (de l'onglet plus)
Pour l'option Types, la sortie de liste filtrée sélectionne chaque valeur trouvée dans le champ type, comme exposé çi-dessous. Le filtre d'entrée filtre les tiddlers (non-système) de ce type.
Dans l'onglet Récent la liste est générée en utilisant la macro timeline. Ici, la sortie de liste filtre chaque jour trouvé dans le champ modifié, tandis que l'entrée de liste filtre tous les tiddlers datés du même jour dans le champ modifié.
<!-- Override one or both of the following two macros with a global or local macro of the same name
if you need to change how titles are displayed on a timeline -->
\define timeline-title() <$view field="title"/>
\define timeline-link() <$link to={{!!title}}><<timeline-title>></$link>
\define timeline(limit:"100",format:"DDth MMM YYYY",subfilter:"",dateField:"modified")
\whitespace trim
<div class="tc-timeline">
<$list filter="[!is[system]$subfilter$has[$dateField$]!sort[$dateField$]limit[$limit$]eachday[$dateField$]]">
<div class="tc-menu-list-item">
<$view field="$dateField$" format="date" template="$format$"/>
<$list filter="[sameday:$dateField${!!$dateField$}!is[system]$subfilter$!sort[$dateField$]]">
<div class="tc-menu-list-subitem">
<<timeline-link>>
</div>
</$list>
</div>
</$list>
</div>
\end
Une étape majeure dans la croissance de TiddlyWiki fut la création de GTDTiddlyWiki par Nathan Bowers. Il partit du TiddlyWiki de base et l'adapta spécifiquement pour la gestion et le suivi de tâches à l'aide de la méthodologie bien connue Getting Things Done. GTDTiddlyWiki fut un succès immédiat, salué avec enthousiasme par des sites comme LifeHacker.
Dans les années qui suivirent, TiddlyWiki continua à croître en popularité, et s'enrichit de nouvelles fonctions et possibilités. En un an, je pus trouver une indépendance financière en proposant du développement sur mesure autour de TiddlyWiki, notamment en travaillant avec un pionnier du wiki, SocialText, sur la possibilité de synchroniser des modifications avec un serveur en ligne.
TiddlyWiki makes a great GuerillaWiki in situations where it is not practical to use a traditional wiki.
For instance, in a corporate setting, persuading an over-worked IT department to install a Wiki server for you is seldom going to be possible overnight. And if your PC is locked down you can't install a conventional Wiki yourself. Equally, you can't go and use one of the public hosted Wiki services because your Information Security department would not allow all that corporate data to flow into an outside server.
TiddlyWiki slices through those barriers by being usable on virtually all PCs.
{
"Shakespeare-old": "Hamlet: Do you see yonder cloud that's almost in shape of a camel?\nPolonius: By the mass, and 'tis like a camel, indeed.\nHamlet: Methinks it is like a weasel.\nPolonius: It is backed like a weasel.\nHamlet: Or like a whale?\nPolonius: Very like a whale.\n-- Shakespeare",
"Shakespeare-new": "Hamlet: Do you see the cloud over there that's almost the shape of a camel?\nPolonius: By golly, it is like a camel, indeed.\nHamlet: I think it looks like a weasel.\nPolonius: It is shaped like a weasel.\nHamlet: Or like a whale?\nPolonius: It's totally like a whale.\n-- Shakespeare",
"Trekkie-old": "Kirk: Do you see yonder cloud that's almost in shape of a Klingon?\nSpock: By the mass, and 'tis like a Klingon, indeed.\nKirk: Methinks it is like a Vulcan.\nSpock: It is backed like a Vulcan.\nKirk: Or like a Romulan?\nSpock: Very like a Romulan.\n-- Trekkie"
}
Le traitement habituel des paragraphes en WikiTexte implique que les retours à la ligne simples sont ignorés, tandis que deux retours à la ligne sont interprétés comme la fin d'un paragraphe.
Ce comportement n'est pas pratique pour du texte qui intègre des retours à la ligne – par exemple, pour de la poésie.
Syntaxe en bloc
Un bloc de contenu délimité par trois caractères "guillemets doubles" """ permet d'indiquer que les fins de ligne doivent y être forcées :
"""
Ceci est une ligne
et ceci est une nouvelle ligne
tandis que cela est encore une autre ligne
et ceci est la dernière
excepté celle-ci
"""
Affichera ceci :
Ceci est une ligne et ceci est une nouvelle ligne tandis que cela est encore une autre ligne et ceci est la dernière
excepté celle-ci
Remarque
Contrairement à d'autres syntaxes en bloc, celle-ci ne requière pas que ses marqueurs soient seuls sur une ligne : ils pourraient être placés n'importe où, même au milieu du texte.
Syntaxe HTML
Les fins de lignes ne devraient pas être forcées dans un texte courant, car cela peut déformer l'affichage sur des terminaux mobiles.
Cependant, dans des cas exceptionnels, la balise HTML<br> peut être utilisée pour revenir à la ligne sans créer de nouveau paragraphe :
Ceci est une première ligne.<br>
Ceci est une deuxième ligne.<br>Et cela est une troisième ligne.
Affichera ceci :
Ceci est une première ligne.
Ceci est une deuxième ligne. Et cela est une troisième ligne.
Remarque
Plusieurs <br> d'affilée permettent de créer artificiellement un espacement de plusieurs lignes.
If rendered without the tag, the content of "Hard Linebreaks with CSS - Example" will be shown like this:
The following text is rendered without any special WikiText syntax. So most of the WikiText functionality will be accessible.
This is a line
and this is a new line
while this is yet another line
and this is the final one
apart from this one
without suffix » those input tiddlers in which field F has a non-empty value suffix field » those input tiddlers in which field F exists suffix index » those input data tiddlers in which index F exists
! output
without suffix » those input tiddlers in which field F does not exist or has an empty value suffix field » those input tiddlers in which field F does not exist suffix index » those input data tiddlers in which index F does not exist
A tiddler is deemed to have been modified if it has been written back to the wiki since the start of the current TiddlyWiki session. If you edit a tiddler and immediately store it again without making any changes, that is enough to mark it as modified.
Utilisez-le pour gérer votre liste de tâches, faire le plan d'un essai ou d'une nouvelle, ou pour organiser votre mariage. Enregistrez tout ce qui vous traverse l'esprit, ou construisez un site web flexible et réactif.
Contrairement aux services en ligne classiques, TiddlyWiki vous permet de choisir où conserver vos informations, et garantit que, dans les décennies à venir, vous pourrez toujours utiliser les notes que vous prenez aujourd'hui.
Si vous appréciez l'utilité de TiddlyWiki, il y a plusieurs façons d'aider à l'améliorer et à assurer son avenir.
Former et Promouvoir
Les Projets OpenSource comme << tw >> prospèrent grâce aux réactions et à l'engagement des utilisateurs. Plus TiddlyWiki deviendra d'autant plus utile à tous que nous serons de plus en plus nombreux à l'utiliser. Aussi, Si vous appréciez l'utilité de TiddlyWiki, faites le savoir. Le meilleur moyen de garantir son avenir est de devenir des centaines de fois plus populaire qu'auparavant.
A default tiddler icon can be specified by creating a tiddler called $:/config/DefaultTiddlerIcon containing the title of the tiddler containing the icon.
To selectively re-enable drag and drop for an instance of the list-tagged-draggable Macro or list-links-draggable Macro you must ensure that the variable tv-enable-drag-and-drop is set to yes for the scope of the macro invocation. For example, note how it is still possible to use drag and drop within this list even if $:/config/DragAndDrop/Enable is set to "no":
This filter determines whether dragging and dropping files in the editor works for a given tiddler or not. A non-empty result enables drag and drop in the editor for that tiddler.
This filter is used in such a manner that it respects the global drag and drop setting.
Depuis : 5.1.19 When saving a TiddlyWiki using the enregistrer les modifications button, the default file name used for saving is constructed using the Title of the TiddlyWiki as entered in the Control Panel, which is stored in the tiddler $:/SiteTitle.
The value used is in the form {{$:/SiteTitle}}.html. This causes the filename to be constructed from the site Title with a .html extension.
If a tiddler named $:/config/SaveWikiButton/Filename is created, the text in that tiddler will be used as the default file name used for saving the TiddlyWiki.
Depuis : 5.2.0 By default, tiddlers with the type text/html are displayed in an iframe with the sandbox attribute set to the empty string. This causes all security restrictions to be applied, disabling many features such as JavaScript, downloads and external file references. This is the safest setting.
To globally disable the sandbox, set the tiddler $:/config/HtmlParser/DisableSandbox to yes. This will mean that the code in the iframe has full access to TiddlyWiki's internals, which means that a malicious HTML page could exfiltrate data from a private wiki.
The configuration Tiddler $:/config/Search/NavigateOnEnter/enable can be used to enable (if set to yes) Navigation to and Creation of missing Tiddlers in the various search input fields when hitting Enter respectively ctrl-Enter
As part of navigating to a tiddler, TiddlyWiki scrolls the page so that the top of the tiddler lines up with the top of the browser window. This means that the upper part of tiddlers can be obscured when using custom position:fixed toolbars at the top of the window.
To adjust the scroll position to allow for the toolbar, add the CSS class tc-adjust-top-of-scroll to the toolbar. TiddlyWiki's scrolling mechanism will then dynamically adjust the scroll position by the height of that element.
When TiddlyWiki first opens in the browser the search box is automatically given the focus by default. If this causes problems, you can change the default by changing this value from true to false:
Depuis : 5.1.23 Determines whether system tiddlers are synced from the server under Node.js. (Note that this is a one-way setting; system tiddlers are always synced to the server).
no – system tiddlers are not synced from the server (default)
yes – system tiddlers are synced from the server
Engaging sync of system tiddlers means that tiddlers such as $:/StoryList and $:/HistoryList get synced, which can lead to unexpected outcomes when multiple users are connected to the same server at the same time (it means that the story sequence is synced between all the users).
The input fields of Tiddlers that are being edited can be assigned a tabindex value (preferably 1) so that the Tab key can be used to directly move the focus from one input to the next or backwards using shift-Tab
TiddlyWiki defers processing changes to draft tiddlers and tiddlers with the prefix $:/temp/volatile/ until a timeout has elapsed (this is called throttling). The mechanism can be extended to other tiddlers by adding a throttle.refresh field. See RefreshThrottling for details.
The default value of 400ms gives a good balance of responsiveness in most cases but isn't always optimal on lower powered mobile devices.
The timeout can now be changed by changing this value (in milliseconds):
The most useful configuration settings for TiddlyWiki are exposed in the control panel but some more advanced settings do not have a full user interface. Instead, the underlying configuration tiddlers are edited directly.
To change these settings on an empty TiddlyWiki, you can drag the links to the individual configuration tiddlers directly from this wiki into yours.
This filter determines which contentTypes can be imported by dragging and dropping into the editor. It used by a DropzoneWidget wrapped around the editor, for the contentTypesFilter attribute.
En 1997, un collègue me montra le wiki original de Ward Cunningham. Que quelque chose d'aussi puissant puisse être écrit en seulement 700 lignes de Perl m'impressionna à l'époque, et j'étais aussi fasciné par la manière radicale dont la sécurité et le système de permissions avaient été repensés. Comme beaucoup d'autres développeurs, je me suis jeté sur tous les types de wiki qui me passaient sous la main, afin d'explorer leur utilisation en environnement de travail.
Le principal attrait du wiki pour moi était le sentiment qu'il pouvait remettre en question le paradigme qui prévalait jusqu'alors, à savoir les documents conçus pour être imprimés, et les emails.
Après avoir observé pendant quelques années la manière dont les gens utilisaient les wikis, j'ai remarqué que les utilisateurs avancés faisait grand usage de la possibilité d'ouvrir plusieurs pages de wiki à la fois dans les onglets de leur navigateur, pour se faciliter la comparaison et la révision des pages, la recopie de texte d'une page à l'autre, et pour se constituer une sorte de file de pages en attente d'être lues.
J'ai eu le sentiment que cette capacité à manipuler plusieurs pages en même temps était centrale dans la capacité à réorganiser un wiki, et on considère généralement qu'un wiki réorganisé avec amour a tendance à être plus utile. Pourtant, les interfaces utilisateur des wiki ont toujours été exclusivement conçues pour la présentation et la manipulation d'une seule page à la fois.
Toutes ces réflexions se sont synthétisées lorsque j'ai vu l'interface de Gmail en avril 2004, qui utilisait Ajax de manière ingénieuse pour assembler des mails individuels dans des fils de conversations.
J'ai commencer à expérimenter avec HTML et JavaScript pour pousser l'idée. Je n'avais eu jusqu'à présent pratiquement aucune expérience de l'un ou de l'autre, à part composer quelques pages statiques et des sites ASP simples dans des vies précédentes. Se plonger dans ces techniques orientées client a été une expérience douloureuse ; comme tout le monde, j'étais horrifié de découvrir l'atrocité des incompatibilités et incohériences de la programmation web.
En septembre 2004, j'ai donc publié une version préliminaire de TiddlyWiki. Il s'agissait de la plus petite application possible démontrant le concept : un simple fichier HTML de 48KB qui s'auto-engendrait.
L'inconvénient d'avoir écrit de cette manière la première version de TiddlyWiki, c'est que ça la rendait complètement impraticable pour l'édition — quand vous cliquiez sur « enregistrer les modifications », elle faisait apparaître une fenêtre montrant les données qui auraient été enregistrées s'il avait été possible d'écrire sur le système de fichiers depuis une page HTML.
Un grande partie des premiers commentaires sur TiddlyWiki étaient que c'était un outil sympathique, mais qu'il aurait été plus utile si on avait pu enregistrer correctement les modifications. J'étais plutôt frustré, car je tenais pour certaine l'impossibilité pour un fichier HTML tournant dans un navigateur d'enregistrer des modifications sur le système de fichiers local.
Quelques mois plus tard, j'ai repéré une extension Firefox expérimentale qui permettait à TiddlyWiki de sauvegarder les modifications depuis le navigateur. En examinant le code, je réalisai que l'API utilisée pour écrire sur le système de fichiers était en fait disponible pour les fichiers HTML ordinaires — pourvu qu'ils soient chargés depuis une URI de type file://.
J'adaptai le code Firefox dans le noyau de TiddlyWiki et j'ajoutai bientôt une fonctionnalité similaire pour Internet Explorer (en utilisant un ancien contrôle ActiveX que Microsoft distribuait avec Internet Explorer).
Une étape majeure dans la croissance de TiddlyWiki fut la création de GTDTiddlyWiki par Nathan Bowers. Il partit du TiddlyWiki de base et l'adapta spécifiquement pour la gestion et le suivi de tâches à l'aide de la méthodologie bien connue Getting Things Done. GTDTiddlyWiki fut un succès immédiat, salué avec enthousiasme par des sites comme LifeHacker.
Dans les années qui suivirent, TiddlyWiki continua à croître en popularité, et s'enrichit de nouvelles fonctions et possibilités. En un an, je pus trouver une indépendance financière en proposant du développement sur mesure autour de TiddlyWiki, notamment en travaillant avec un pionnier du wiki, SocialText, sur la possibilité de synchroniser des modifications avec un serveur en ligne.
En mai 2007, British Telecom a acquis Osmosoft, ma société de consultant. Acquérir une société avec un seul employé et un minuscule filet de revenu relevait d'une décision inhabituelle, Osmosoft ne détenant même pas la propriété intellectuelle de TiddlyWiki, puisque je l'avais transférée à UnaMesa pour assurer son avenir pour la communauté.
La motivation de British Telecom était de mieux comprendre les écosystèmes basés sur les communautés. Je rejoignis la société en tant que « Head of Open Source Innovation », responsable de la gouvernance open source, et fournissant des conseils et de l'expertise sur la manière de participer à des communautés open source.
Je constituais une équipe chez BT sous le nom Osmosoft. Nous avions comme objectif d'évangéliser les bénéfices de l'open source et d'aider d'autres équipes à réaliser ces bénéfices en pratique. Nous nous sommes aussi rendu compte qu'il était nécessaire d'évangéliser l'usage du Web en général, et les standards web en particullier.
Notre approche était de privilégier la démonstration sur le discours. Nous avons travaillé avec la communauté TiddlyWiki pour étendre l'écosystème, et nous avons construit de nombreux systèmes internes pour BT (certains basés sur TiddlyWiki, d'autres non).
La principale contribution d'Osmosoft à la communauté TiddlyWiki fut la création de TiddlyWeb et TiddlySpace. TiddlyWeb était un serveur robuste, capable de servir des tiddlers sur l'Internet, mais aussi de composer des vues TiddlyWiki à partir de ces tiddlers. Quant à TiddlySpace, il s'agissait d'une tentative pour packager TiddlyWeb de façon plus directement utilisable.
Fin 2011, j'ai progressivement senti que j'aurais plus de latitude hors de l'enceinte de British Telecom pour réaliser le potentiel de TiddlyWiki. D'un commun accord, je suis parti et j'ai commencé à travailler comme développeur indépendant, en me concentrant principalement sur une réincarnation de TiddlyWiki, qui pris la forme de TiddlyWiki5.
J'ai travaillé sur une nouvelle version de TiddlyWiki à partir de novembre 2011. En tant que programmeur, travailler à une « version 2.0 » de quelque chose que j'avais déjà écrit était une projet très séduisant. Cela signifiait que les besoins étaient bien compris, et je pouvais dès lors me concentrer sur l'architecture et ses évolutions nécessaires à la mise en œuvre des fonctionnalités désirées.
À présent que TiddlyWiki5 a enfin quitté son statut de « beta », j'ai bon espoir qu'il vivra longtemps. Comme il n'utilise que des fonctionnalités standard de HTML5 et Node.js, il n'y a aucune raison pour qu'il ne reste pas entièrement opérationnel dans les années qui viennent. Mon but est qu'il survive au moins 25 ans.
Le tiddler système $:/HistoryList garde la trace d'une liste de tiddlers composé de l'historique de navigation. Chaque fois que vous cliquez sur un lien vers un tiddler, le titre du tiddler cible est ajouté au sommet de la pile.
La liste historique est mémorisée en JSON qui permettent des détails additionnels au sujet des coordonnées du nœud DOM initialisant la navigation. Ce champ peut être utilisé comme suit :
Pour afficher un contenu lorsque le déroulé est vide, créez un $:/config/EmptyStoryMessage et entrez le contenu souhaité. Le cas suivant montrerait le tiddler GettingStarted quand tous les autres sont fermés.
Assurez-vous que le texte commençant par "Can you help us improve this documentation?" est approprié pour vos visiteurs
Remplacez le lien vers Améliorer la documentation de TiddlyWiki par un lien vers le tiddler qui contient vos instructions pour votre propre procédure de contributions.
Si vous souhaitez créer un onglet de table des matières, vous pouvez peupler ce nouveau tiddler à l'aide de la Macro TableOfContents. Regardez par exemple comment fonctionne Table des matières
Par défault, libellé de l'onglet correspond au titre du tiddler, mais vous pouvez le remplacer en remplissant le champ caption.
Pour définir l'ordre des onglets, servez-vous des champs list-after ou list-before, comme expliqué dans Étiquetez par tags
Par exemple : donnez à list-after la valeur $:/core/ui/SideBar/Open pour placer un onglet de barre latérale juste après l'onglet « Open » (Ouverts)
Notez qu'il est possible de créer de la même manière de nouveaux onglets sous l'onglet « More » (Plus), en utilisant le tag $:/tags/MoreSideBar.
Vous pouvez appliquer des styles personnalisés aux tiddlers ayant un tag particulier en définissant une classe CSS nommée tc-tagged-<Nom du tag>.
Par exemple, pour coloriser les tiddlers étiquetés "NightReader" d'une façon spéciale, Créer une feuille de style définissant la classe tc-tagged-NightReader comme suit :
La classe tc-tagged-NightReader s'applique au tiddler tou entier et pas seulement au texte du tiddler. Si vous désirez l'appliquer à une portion plus réduite du tiddler vous pouvez ajuster le sélecteur CSS, comme ici avec .tc-tagged-NightReader .tc-tiddler-body.
Notez que les tags contenant des espaces et des caractères non-alphanumériques seront convertis en utilisant le codage URI, rendant le nom de classe CSS généré difficile à prévoir. Par exemple :
The sorting is fine for most cases, but you would like all your items tagged Journal to be sorted by the created field. How can you apply a separate sort order to just those sub-items tagged Journal?
The trick is to add a field to the parent tagging tiddler (i.e. Journal) that points to a different sort criteria. Let's call the field fuzzy, and populate it with the value created (created is the name of the field that contains a tiddler's creation date).
Now your Table of Contents will sort by title everywhere, except for the children of the Journal tiddler, which will sort by the created date.
The downside to this trick is that you can't apply a reverse sort based on just one special field. If you reverse the sort order, it will be reversed everywhere.
Here we show how to add a rule to the Story Tiddler Template Cascade that causes tiddlers tagged $:/tags/TiddlerList to be displayed with a custom appearance incorporating thumbnails of the tiddlers named in the list field.
The story tiddler template cascade is defined by the tag $:/tags/StoryTiddlerTemplateFilter, so we need to create a configuration tiddler with that tag.
We also need to make sure that it is inserted at the correct point in the cascade:
The new rule must be after the "draft" rule to ensure that draft tiddlers with the tag $:/tags/TiddlerList can be edited
The new rule must be before the "default" rule otherwise it will never be executed
The control panel "Cascades" tab shows that this can be achieved by inserting the new step immediately before the default step using the list-before field.
The full list of fields in the configuration tiddler is:
HelloThere Community GettingStarted Features Reference Plugins Learning
modified
20211204131610322
tags
$:/tags/TiddlerList
text
This is a demo tiddler with a custom story tiddler template that displays the tiddlers named in the list field as a fan.
See [[How to create a custom story tiddler template]] for details.
Here we show how to add a rule to the Tiddler Colour Cascade that causes tiddlers with the tag Table des matières to be given a bright blue colour and tiddlers with the tag Travailler avec TiddlyWiki to be given a dark purple colour.
First, we add a new step to the tiddler colour cascade. The new filter step is:
[tag[TableOfContents]then[#1e90ff]]
[tag[Working with TiddlyWiki]then[darkorchid]]
It can be read as:
If the tiddler has the tag "TableOfContents" then return the colour #1e90ff
Else if the tiddler has the tag "Working with TiddlyWiki" then return the colour darkorchid
The tiddler colour cascade is defined by the tag $:/tags/TiddlerColourFilter, so we need to create a configuration tiddler with that tag.
We also need to make sure that it is inserted at the correct point in the cascade:
The new rule must be after the "colour-field" rule to ensure that tiddlers with an explicit color field will respect the value of that field
The new rule must be before the "default" icon otherwise it will never be seen if the default colour is specified
The control panel "Cascades" tab shows that this can be achieved by inserting the new step immediately before the default step using the list-before field.
The full list of fields in the configuration tiddler is:
Here we show how to add a rule to the Tiddler Icon Cascade that causes tiddlers with the tag Table des matières to be given the "globe" icon and tiddlers with the tag Travailler avec TiddlyWiki to be given the "help" icon .
First, we add a new step to the tiddler icon cascade. The new filter step is:
[tag[TableOfContents]then[$:/core/images/globe]]
[tag[Working with TiddlyWiki]then[$:/core/images/help]]
It can be read as:
If the tiddler has the tag "TableOfContents" then return $:/core/images/globe
Else if the tiddler has the tag "Working with TiddlyWiki" then return $:/core/images/help
The tiddler icon cascade is defined by the tag $:/tags/TiddlerIconFilter, so we need to create a configuration tiddler with that tag.
We also need to make sure that it is inserted at the correct point in the cascade:
The new rule must be after the "icon-field" rule to ensure that tiddlers with an explicit icon field will respect the value of that field
The new rule must be before the "default" icon otherwise it will never be seen if the default icon is specified
The control panel "Cascades" tab shows that this can be achieved by inserting the new step immediately before the default step using the list-before field.
The full list of fields in the configuration tiddler is:
You can use any "state tiddler" to define the button disabled state. It's important, that the condition-disabled field is a filter. For our example we use the state-disabled field from tiddler: $:/temp/bold/disabled
The easiest way to test filters is with the $:/AdvancedSearch : Filter tab
The temporary "bold button" is disabled: "no" ... You can see the button in the editor toolbar if you edit any tiddler!
Create Keyboard Shortcuts for New Button
For our HowTo we use the Keyboard Shortcut Descriptor: ((temp-bold))
To create a valid shortcut configuration we need 2 tiddlers:
TiddlyWiki distinguishes two types of keyboard shortcuts. Those that are limited to work within input fields or textareas which are handled by the $keyboard widget and keyboard shortcuts that work globally - which means that only the page needs to have focus in order for them to be accessible. The latter are handled by a mechanism that starts to work when a wiki is loaded
The configuration mechanism is the same for both shortcut-types
A tiddler with the prefix $:/config/ShortcutInfo/ and a unique suffix appended, like my-shortcut, makes the new shortcut appear in the $:/ControlPanel within the Keyboard Shortcuts Tab. An optional description can be added within its text field
In the Keyboard Shortcuts Tab the key combination that should trigger the shortcut can be configured:
Look for the unique suffix defined for the new shortcut and click the button to open a popup that detects key combinations and shows the detected combination in its input field
The add shortcut assigns the key-combination to the shortcut
Depending on the chosen platform the configuration mechanism creates a tiddler with a specific nomenclature
$:/config/shortcuts/ + the shortcut suffix for shortcuts that will work on all platforms (operating systems)
$:/config/shortcuts-(mac/not-mac/windows/not-windows/linux/not-linux)/ + the shortcut suffix for shortcuts that will work on the chosen platform only or that will not work on the excluded platform
Examples
$:/config/shortcuts/my-shortcut
$:/config/shortcuts-mac/my-shortcut
$:/config/shortcuts-windows/my-shortcut
$:/config/shortcuts-linux/my-shortcut
$:/config/shortcuts-not-mac/my-shortcut
$:/config/shortcuts-not-windows/my-shortcut
$:/config/shortcuts-not-linux/my-shortcut
Note that those platform-specific tiddlers don't have to be created manually if the ShortcutInfo tiddler as mentioned above is created first and the shortcut is configured in the ControlPanel
At this point the shortcut is defined and its actions can be configured
A $keyboard widget detects the key combinations pressed within an input or textarea field within its scope. The $keyboard widget needs to "embrace" the input or textarea field and its key attribute either points to a configuration tiddler using the Key Descriptor Syntax or explicitely contains the key
If actions are defined , the $keyboard widget will invoke the actions defined in its actions attribute when it detects the key-combination defined in its key attribute being pressed in any input or textarea field within its scope
Using global Keyboard Shortcuts
See Keyboard Shortcut Tiddler for detailed information about creating new global keyboard shortcuts.
The actions for global keyboard shortcuts are stored in the text field of tiddlers tagged with $:/tags/KeyboardShortcut
The key field connects an action-tiddler with the corresponding shortcut through the ((my-shortcut)) syntax, called Keyboard Shortcut Descriptor
Syntax: (( + a chosen suffix + ))
If the tiddler has the tag $:/tags/KeyboardShortcut, the field key with the Keyboard Shortcut Descriptor as its value and some actions in its text field, the actions will be triggered when the mechanism detects the configured key-combination
Macros defined outside a global keyboard-shortcut (through a tiddler tagged $:/tags/Global) need to be imported in order to be accessible.
The import pragma can be used for that
If the tiddler that contains the macro definition is known and - for example - titled my-macro-tiddler
\import my-macro-tiddler
Some actions require to be wrapped within a $navigator widget. That is necessary for the following list of widgets and messages in order to work if used within global keyboard shortcuts
Avant d'expérimenter avec les entrailles de TiddlyDesktop, vous devriez noter l'emplacement du « dossier de configuration utilisateur » : cliquez sur le bouton « Settings » de la fenêtre principale de TiddlyDesktop, puis cliquez sur le bouton « Open user config folder ». Ensuite, remontez d'un niveau pour localiser le dossier parent, qui devrait s'appeler « TiddlyDesktop ». Si quelque chose se passe mal, vous pouvez restaurer l'état d'origine de TiddlyDesktop en supprimant ce dossier et son contenu.
Cliquez sur le bouton « Backstage » de la fenêtre principale de TiddlyDesktop pour ouvrir le wiki d'infrastructure qui tourne en coulisses. C'est une pseudo-instance de TiddlyWiki sous Node.js qui fournit l'interface utilisateur et la mécanique de TiddlyDesktop.
Comment me débarrasser du bouton « Add a TiddlyWiki Folder » ?
Dans le wiki d'infrastructure, localisez le tiddler WikiListToolbar (il y a un lien dans HelloThere). Passez en mode d'édition, et vous verrez le WikiTexte des boutons de barre d'outils. Si vous faites des modifications et les enregistrez, elles seront immédiatement prises en compte dans la fenêtre principale de TiddlyDesktop.
Comment changer le bouton « advanced » en bouton « reveal backups » ?
Vous pouvez copier le code du bouton « reveal backups » disponible dans le tiddler $:/TiddlyDesktop/Settings, et le coller dans WikiListToolbar.
Comment modifier les couleurs ?
Comme d'habitude dans TiddlyWiki : vous pouvez utiliser la palette, ou définir vos propres CSS.
Comment changer l'ordre d'apparition des tiddlers (qui semble alphabétique) ?
Ouvrez le tiddler WikiList en mode édition, naviguez jusqu'en bas du code, et modifiez le widget <$list> à l'intérieur de la macro « wikilist » :
<$list filter="[tag[wikilist]sort[title]!has[draft.of]]" emptyMessage="Add a ~TiddlyWiki file or folder to get started. Click the buttons above to browse, or drag and drop from your file Explorer/Finder" storyview="pop">
Note: Before we dive into how you can embed files of a certain type, you may want to consider not embedding and instead simply linking to external resources like this:
[ext[title|path/to/that.file]]
Then let your browser decide how to handle the resource. The advantage to this approach is that it is simple and quick. The disadvantage is that the file doesn't actually travel with the TW5 file and that you can't use node.js with method #2 below to quickly file paths.
Two ways to embed a PDF in your TW5 file.
1. Embedding with Drag and Drop
One is to drag and drop the file onto your TW5 file. Wait for the green bar to appear at the top, drop, and then import from the import tiddler. This actually embeds the contents of your imported PDF (or other file) into your TW5 file.
This method be OK as long as your PDF is not too big. There can be concerns if your TW5 file becomes too big.
2. Embedding with '_canonical_uri'
The other way is to create a tiddler link to the external file. In this method the file is not actually incorporated into your TW5 file, but can be accessed with the {{My Image File.jpg}} transclusion syntax just like an embedded file. The location address of the file can also be changed under node.js. See ExternalImages for details of using external images with node.js.
Create a tiddler with a field _canonical_uri. Put in the local address to the external file. Set the type field to application/pdf.
With either way, with an appropriately configured browser, you should see your embedded PDF file.
Other File Types
There's only so many file formats that TW5 knows about. There is a list at ContentType. If your browser and/or TW5 doesn't know what to do with a particular file format, then you can only the use the second method to embed and then download a file. When you edit the tiddler a link is presented. You can right click on the link in order to download the file.
Pour exporter tous les tiddlers, cliquez sur l'onglet Outils de la barre latérale. Trouvez le bouton exporter tout et cliquez dessus. Un menu flottant vous permet alors de choisir l'un des nombreux formats d'exportation des tiddlers.
Exporter un tiddler
Pour exporter un tiddler particulier, commencez par l'afficher, puis cliquez sur le bouton plus situé vers le haut du tiddler. Dans la liste qui apparaît, sélectionnez exporter ce tiddler. Un menu flottant vous permet alors de choisir l'un des nombreux formats d'exportation des tiddlers.
Exporter des tiddlers selon un critère (filtre)
Pour exporter une sélection de tiddlers, cliquez sur le symbole de loupe à proximité de la zone de recherche de la barre latérale, ce qui va ouvrir le tiddler de recherche avancée. Choisissez l'onglet Filtrer car c'est le seul qui permet d'exporter une sélection de tiddlers. Les filtres utilisent une syntaxe particulière, cliquez sur ce lien pour découvrir comment concevoir des filtres.
Lorsque vous aurez rédigé un filtre, la liste des tiddlers correspondants apparaîtra. Vous pourrez alors cliquer sur le bouton Exporte ces tiddlers situé à droite de la zone de saisie du filtre. Un menu flottant vous permettra alors de choisir l'un des nombreux formats d'exportation des tiddlers.
Formats d'exportation
Actuellement, les formats d'exportation disponibles sont :
Le fichier au format CSV
Le fichier au format JSON
Le fichier HTML statique
Le fichier au format « .tid »
Le format « .tid » est particulier en ce qu'il ne permet d'exporter qu'un seul tiddler à la fois, même si vous essayer d'en exporter plusieurs à l'aide d'un filtre ou avec le bouton exporter tout.
Si nécessaire, modifier la valeur background-color à votre convenance
Vous pouvez aussi essayer de modifier le positionnement de la classe de right à right-bottom
Pour faire apparaitre la bannière dans le coins supérieur gauche vous devrez étiqueter le $:/tags/PageTemplate au lieu de $:/tags/PageControls et changer la position de la classe à left
You can use the search-replace Operator in combination with the sortsub Operator to ignore stop words like "A" and "The" at the beginning of titles when sorting. (Note for example that "A Tale of Two Cities" sorts under "T" rather than "A")
CamelCase is used in most Wikis, but it can interfere with text presentation in some situations.
Turning off Camel Case locally
To turn off a particular instance of a CamelCase text, simply put a tilde (~) in front of the word, like this:
~CamelCase
Turning off Camel Case globally
To turn off CamelCase in all tiddlers, navigate to the Control Panel. Select the Settings tab and then scroll or read down to the Camel Case Wiki Links section and unselect Enable automatic CamelCase linking.
De nouvelles versions de TiddlyWiki sont publiées régulièrement, avec des améliorations et des corrections de bogues. Il est recommandé de rester à jour en hissant votre wiki au niveau de la dernière version.
Introduction
La procédure décrite ici est réservée à la mise à niveau de fichiers TiddlyWiki autonomes. Pour mettre à niveau TiddlyWiki sur Node.js, il existe une méthode différente.
Il est de votre responsabilité de vous occuper de vos données ; prenez soin d'effectuer des sauvegardes, surtout quand vous mettez à niveau le noyau de TiddlyWiki.
Mise à niveau en ligne
Cette procédure fonctionnera sur la plupart des navigateurs de bureau. Notez que vos données personnelles ne quittent pas votre navigateur pendant la procédure.
Localisez votre fichier TiddlyWiki sur le système de fichiers (à l'aide de Windows Explorer, du Finder sur Mac OS X, ou de votre gestionnaire de fichiers sur Linux)
Faites glisser votre ancien fichier TiddlyWiki HTML sur la fenêtre du navigateur
Si le fichier est crypté, un mot de passe vous sera demandé
Passez en revue la liste des tiddlers qui seront mis à niveau
Cliquez sur Upgrade
Enregistrer les changements pour sauvegarder la nouvelle version
Cela aura pour résultat de télécharger sur votre ordinateur un fichier nommé upgrade.html. Ce fichier constitue la version à niveau de votre ancien fichier. Il se peut que vous deviez vous rendre là où upgrade.html a été téléchargé, renommer upgrade.html avec le nom de l'ancien fichier que vous mettez à niveau, et remplacer l'ancien fichier en déplaçant le nouveau à sa place.
Mise à niveau hors ligne
Vous pouvez également télécharger le fichier https://tiddlywiki.com/upgrade.html localement et effectuer la même procédure de glisser-déposer pour mettre vos fichiers à niveau.
Problèmes avec les mises à niveau
Il est possible qu'une personnalisation appliquée dans une version précédente devienne inopérante une fois la mise à niveau effectuée. Deux techniques peuvent être employées pour vous aider à retrouver l'origine du problème :
Essayez de répéter la mise à niveau en décochant tous les tiddlers qui pourraient contenir des personnalisations de TiddlyWiki
Utilisez le ModeSansÉchec pour désactiver toutes les adaptations personnalisées des tiddlers shadow
Vous pouvez voir quels tiddlers shadow ont été modifiés dans l'onglet Filtres de la recherche avancée. Choisir "Les tidders shadow modifiés" depuis le menu déroulant.
You can change the width of the main column of tiddlers (also known as the story river) by:
Clicking on the settings cog to open the control panel
In the control panel select "Appearance" and then "Theme Tweaks".
Under Theme tweaks, scroll down.
There you will see settings for story right, story width, and tiddler width. By setting these numbers to something larger, you can widen the tiddlers. In general, story right and story width should be the same size, and tiddler width a little bit smaller. You could even use percentages for tiddler width. You will also probably want to change the sidebar breakpoint to something larger than the story river, unless you don't mind the sidebar floating to the top of the page.
HTML (Hypertext Markup Language) elements historically were categorized as either "block-level" elements or "inline-level" elements. Since this is a presentational characteristic it is nowadays specified by CSS in the Flow Layout. A Block-level element occupies the entire horizontal space of its parent element (container), and vertical space equal to the height of its contents, thereby creating a "block".
Use HTML entities to enter characters that cannot easily be typed on an ordinary keyboard. They take the form of an ampersand (&), an identifying string, and a terminating semi-colon (;), e.g. & for the & character.
Markup
The value of Tiddlers™ cannot even be expressed in £, € or $.
Displays as:
The value of Tiddlers™ cannot even be expressed in £, € or $.
Entity References
Comprehensive lists of html entities can be found at...
The table below shows how accented characters can be built up by substituting the
underscore (_) in the second table into the corresponding character. eg:
Par conséquent, un mot écrit entre "chevrons" < > sera interprété comme une balise HTML, ce qui peut entraîner des effets de bord (notamment à cause de l'inexistence de la balise fermante). À la place, mieux vaut utiliser le code HTML des caractères "chevrons" : < et >
Commentaires Pragma
Depuis : 5.2.0 Les commentaires peuvent maintenant être librement entremêlés avec les pragmas ou bien à l'intérieur du corps d'un bloc de wikitexte.
<!-- NOUVEAU ! : Commentaire qui décrit la macro -->
\define test()
Un peu de texte <!-- commentaire en ligne -->
\end
<<test>>
Pour que le contenu d'un élément HTML soit interprété en mode bloc, la balise ouvrante doit être suivie par deux retours à la ligne.
Sans les deux retours à la ligne, le contenu des balises sera interprété en mode texte, ce qui signifie que les formatages de mode bloc tels que les tableaux, les listes et les titres ne seront pas reconnus.
Les balises suivantes sont traitées comme si elles étaient vides, ce qui signifie que <balise> est traitée comme si c'était <balise/>, et qu'aucune balise de fermeture </balise> n'est nécessaire. Mais si la balise fermante existe elle est ignorée et traitée comme du texte.
Si vous ne fermez pas n'importe quelle autre balise HTML, TiddlyWiki se comportera comme si les balises manquantes étaient déportées à la fin du tiddler.
Attributs
Par extension à la syntaxe conventionnelle HTML, les attributs des éléments ou widgets peuvent être écrits de différentes façons :
La valeur de l'attribut sera le résultat exact de la transclusion, sans aucune interprétation supplémentaire de WikiTexte. Toute syntaxe de wiki dans ce résultat sera laissée en l'état.
Valeur d'attribut par variable
Les valeurs d'attributs par variable sont encadrées par des doubles crochets autour d'un appel de macro, par exemple :
<div title=<<MaMacro "Jacques">>>
...
</div>
Le texte de la définition de la macro est retrouvé et la substitution des arguments a lieu (c-à-d la syntaxe $param$ et $(...)$). Le texte résultant est affecté à la valeur de l'attribut. Toute syntaxe wiki dans ce texte, y-compris d'autres appels de macros ou des références de variables, sera laissée en l'état.
Valeurs d'attributs par filtre
Les valeurs d'attributs par filtre sont encadrées par des accolades triples autour d'une expression de filtre. Le premier élément de la liste renvoyée par le filtre est affecté à l'attribut, ou une chaîne vide si la liste est vide.
Cet exemple montre comment ajouter un préfixe à une valeur :
La valeur de l'attribut sera le résultat exact du premier élément de la liste renvoyée par le filtre, sans aucune interprétation du WikiTexte. Toute syntaxe de wiki dans ce résultat sera laissée telle quelle.
It is often useful to be able to create HTML links to external resources. For example, here the value of the href attribute will be set to the value of the tiddler MyLinkDestination:
<a href={{MyLinkDestination}}>link</a>
However, there is an unexpected security issue that means that most of the time the link should have the rel attribute set to noopener noreferrer to maintain privacy of the URLs of private TiddlyWiki's (eg on Dropbox). See https://mathiasbynens.github.io/rel-noopener/ for more information.
The image-picker macro displays an interactive image picker, as can be seen in the core text editor.
Parameters
actions
Wikitext for the action widgets that should be executed when the user selects an image. Within the text, the variable imageTitle contains the title of the tiddler containing the selected image.
Voici un exemple d'utilisation des widgets List et Transclude pour afficher une grille de toutes les images système (autrement dit, les tiddlers tagués avec $:/tags/Image).
Les images peuvent être affichées avec la syntaxe WikiTexte suivante, selon que l'image soit déjà incluse dans un tiddler ou pointe vers une source externe :
[img[Motovun Jack.jpg]]
ou [img[https://tiddlywiki.com/favicon.ico]]
Il est également possible d'insérer des tiddlers d'images grâce à la barre d'outils d'édition. Cliquez sur Image () et choisissez une image.
Si la source de l'image correspond au titre d'un tiddler, alors le tiddler est affiché directement. Autrement elle est interprétée comme une URL et la balise HTML <img> est générée avec l'URL dans l'attribut src.
Une info-bulle, visible au survol par la souris, peut être ajoutée :
[img[Et voilà l'info-bulle|Motovun Jack.jpg]]
Les attributs width (largeur) et height (hauteur) ainsi que class pour les classes CSS sont disponibles :
La syntaxe d'image est un raccourci d'appel au Widget Image.
Affichage des images par transclusion
Vous pouvez aussi afficher l'image incluse dans un tiddler en transcluant ce tiddler. L'inconvénient de cette méthode est qu'il n'y a alors pas de moyen direct pour contrôler la taille de l'image.
Utilisez le bouton importer (dans l'onglet de la barre latérale), ou directement un glisser-déposer pour importer une image.
Voir les détails ici : Importer des tiddlers
Depuis : 5.2.0 Vous pouvez aussi importer des images par copier-coller ou glisser-déposer dans l'éditeur de tiddler.
Le widget image affiche des images qui peuvent être désignées par une URL distante ou le titre d'un tiddler local qui contient l'image.
Contenu et attributs
Le contenu du widget <$image> est ignoré.
Attribut
Description
source
L'URL de l'image, ou le titre d'un tiddler image
width
La largeur de l'image
height
La hauteur de l'image
tooltip
L'info-bulle à afficher au survol de l'image
alt
Le texte alternatif associé à l'image
class
Les classes CSS à assigner à l'élément <img>
La valeur de la largeur et de la hauteur peut être attribuée en pixels (c-à-d "23" ou "23px") ou en pourcentages (c-à-d "23%"). Ces deux attributs sont optionnels et s'ils sont absents le navigateur utilisera des règles CSS pour retailler l'image.
Images externes et champ _canonical_uri
Lorsqu'il est utilisé pour afficher des images contenues dans des tiddlers, le widget opère dans deux modes distincts :
Si le champ _canonical_uri est présent, il est utilisé en tant qu'attribut src de la balise <img> générée et le champ text est ignoré.
En l'absence du champ _canonical_uri, le widget image génère une balise <img> qui encode les données de l'image directement dans une URI de type data:.
Importe des tiddlers depuis des fichiers locaux TiddlyWiki (.html), .tiddler, .tid, .json ou autres. Le désérialiseur doit être spécifié explicitement, à la différence de la commande load qui déduit le désérialiseur à utiliser à partir de l'extension du fichier.
Vous pouvez importer des tiddlers dans un TiddlyWiki à partir de fichiers externes ou directement depuis un autre TiddlyWiki.
Importer du contenu de fichiers externes
Il existe plusieurs méthodes pour importer du contenu (tel que du texte, des images, des documents pdf, etc.) à partir de fichiers externes :
Utiliser le bouton Importer (dans l'onglet Outils de la barre latérale) pour choisir un fichier ;
Gisser-déposer des fichiers depuis l'Explorateur Windows, ou le Finder MacOS, etc. directement dans la fenêtre de navigateur de TiddlyWiki ;
Copier-coller du contenu directement depuis le presse-papiers en utilisant le menu ou le raccourci clavier (ctrl-V ou cmd-V)
Actuellement disponible avec Chrome, Firefox et Edge (mais pas Internet Explorer)
Pour la plupart, les fichiers sont importés en tant que tiddlers individuels. Les exceptions sont :
les fichiers .html qui sont reconnus comme des fichiers TiddlyWiki sont interprétés pour en extraire les tiddlers qu'ils contiennent ;
les fichiers .json sont interprétés pour en extraire les tiddlers qu'ils contiennent. Ils peuvent être créés en les exportant d'un autre TiddlyWiki. TiddlyWiki reconnaît les fichiers JSON qui contiennent un unique tiddler, ou un tableau de tiddlers.
Importer du contenu depuis des TiddlyWiki dans d'autres fenêtres
Les tiddlers peuvent être importés depuis des TiddlyWiki affichés dans d'autres fenêtres de navigateurs grâce au glisser-déposer. Faites glisser un lien interne TiddlyWiki ou un tag d'un TiddlyWiki à un autre, entre fenêtres de navigateurs. Faire glisser un lien interne importera un tiddler unique, alors que faire glisser une pilule de tag importera tous les tiddlers qui portent ce tag.
The ImportVariablesWidget imports macro and variable definitions from a list of other tiddlers and makes them available to its children. For example:
<$importvariables filter="[tag[mySpecialMacros]]">
All the macros defined in tiddlers with the tag "mySpecialMacros" are available here
</$importvariables>
Attributes and Content
The content of the importvariables widget is the scope within which the imported variable definitions are available.
Attribute
Description
filter
Tiddler filter defining the tiddlers from which macro definitions will be imported
Global Macros
So-called global macros are implemented within the main page template ($:/core/ui/PageTemplate) by wrapping the page content in the following importvariables widget:
Depuis : 5.1.18 The Pragma: \import is an alternative syntax for using the ImportVariablesWidget. For example, the previous example could be expressed as:
Sur https://tiddlywiki.com, cliquez sur le bouton "edit" du tiddler que vous souhaitez améliorer
Vous devriez voir un bandeau rose avec le texte suivant : Pouvez-vous nous aider à améliorer cette documentation ? Voyez comment éditer ce tiddler sur GitHub.
Cliquez sur le lien externe ...ce tiddler sur GitHub
Une alerte va s'afficher comme quoi « you need to fork this repository to propose changes » (« vous devez cloner ce répertoire avant de pouvoir proposer des modifications »). Un fork est votre propre exemplaire du répertoire, qui intègrera les modifications que vous proposez
Un nouvel onglet devrait s'ouvrir sur votre navigateur, pour permettre d'éditer le tiddler sur github.com. La dernière vidéo montre le contenu attendu dans cette zone.
Sous la boîte d'édition du texte du tiddler, vous devriez voir une boîte indiquant Propose file change
Entrez un titre bref expliquant la modification (par ex., "Clarifier l'instabilité de la syntaxe des attributs")
Si nécessaire, entrez également une description plus détaillée
Cliquez sur le bouton vert intitulé Propose file change
Sur l'écran suivant, cliquez sur le bouton vert intitulé Create pull request
Jermolene ou l'un des autres développeurs principaux sera alors en mesure de fusionner votre pull request de façon à l'intégrer à la prochaine version de https://tiddlywiki.com.
Mario Pietsch a créé pour vous ces tutoriels vidéos :
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
Each input title is processed in turn, and is ignored if it does not denote a data tiddler. The sorted list of property names is retrieved from the data tiddler and then dominantly appended to the operator's output.
Note that behind the scenes, the name/value pairs in a dictionary tiddler are represented as a JSON object. JSON objects do not maintain a guaranteed ordering and so we cannot reliably retain the ordering of the data in the file.
Where the content of a tiddler is in JSON format with an array as its root, the indexes operator retrieves a selection of integer indices instead.
System tiddlers in the namespace $:/info/ are used to expose information about the system (including the current browser) so that WikiText applications can adapt themselves to available features.
Depuis : 5.1.20 Language as reported by browser (note that some browsers report two character codes such as en while others report full codes such as en-GB)
Chaque tiddler a un panneau d'informations additionnelles. Pour l'afficher, cliquez dans la barre d'outils du tiddler, sur l'icone, puis sur info dans la liste déroulante.
Le panneau d'information comporte les onglets suivants :
Outils - propose des boutons pour diverses actions à effectuer sur un tiddler. Cocher la case en regard de chaque bouton l'ajoutera dans la barre d'outils du tiddler - Ceci affectera tous les tiddlers de votre wiki.
Pour contribuer à cette traduction de la documentation tiddlywiki.com, commencez par repérer sur fr-edition.tiddlyspot.com quelques tiddlers non traduits, pas mis à jour, voire mal traduits. Évitez seulement ceux qui sont tagués en cours car comme leur tag l'indique, ils ont été réservés. Ensuite :
si vous travaillez en mode Node.js sur un clone git de l'édition fr-FR, vous pouvez traduire à partir de votre clone en respectant les quelques indications ci-dessous, puis proposer un pull request sur GitHub en vous aidant si besoin de la documentation
sinon, traduisez directement, soit en ligne, soit sur une sauvegarde du site (c'est plus prudent). Puis :
envoyez ce fichier à une personne susceptible d'effectuer un pull request sur GitHub, ou directement sur la liste de diffusion.
Nous ne disposons pas encore de mécanismes très évolués pour gérer le travail de traduction en parallèle, donc ne gardez pas vos traductions sous le coude trop longtemps : il vaut mieux envoyer un tiddler à la fois que s'apercevoir trop tard que quelqu'un d'autre l'a traduit en parallèle.
Les titres des tiddlers sont conservés en anglais
de sorte que les tiddlers traduits soient écrasent la version d'origine au moment d'être servis, et que les références croisées soient maintenues. Pour faire apparaître les titres traduits, utilisez le champ fr-title, ainsi que le paramètre de libellé dans les liens wikitext.
Pour disposer d'un libellé réduit, utile pour les onglets notamment, vous pouvez aussi traduire le champ caption.
Un glossaire est en cours de constitution
Si vous suivez ses propositions, cela augmentera la cohérence de notre traduction. N'hésitez pas à le compléter ou à le critiquer publiquement !
Quelques raccourcis sont à votre disposition
sous forme de macros dans le tiddler $:/editions/fr-FR/util-macros. Ils facilitent la saisie des chaînes de caractères typiquement françaises (comme les « guillemets », mais aussi de mots fréquents (comme TiddlyWiki) ou compliqués comme LaTeX (qui a sa propre feuille de style). N'hésitez pas à en ajouter !
Initialise un dossier wiki (WikiFolder) vide en copiant l'une des éditions présentes dans le répertoire editions.
--init <édition> [<édition> ...]
Par exemple :
tiddlywiki ./MonDossierWiki --init empty
Note :
Le répertoire correspondant au dossier wiki est créé si nécessaire
L'édition par défaut est empty
La commande init échoue si le dossier wiki n'est pas vide
La commande init supprime les éventuelles définitions includeWikis du fichier tiddlywiki.info de l'édition spécifiée
Lorsque plusieurs éditions sont spécifiées, chaque édition écrase les fichiers qu'elle a en commun avec les précédentes (par conséquent, le fichier tiddlywiki.info proviendra de la dernière édition spécifiée)
--editions renvoie une liste des éditions disponibles
Une partie du WikiTexte n'est reconnue que quand l'interpréteur est en mode « en ligne ».
Ces expressions en WikiTexte n'ont pas besoin d'occuper toute une ligne de texte. Elles n'ont pas besoin non plus de tenir en entier sur une seule ligne, mais peuvent couvrir une ligne complète. De ce fait, plusieurs de ces expressions peuvent apparaître au sein de la même ligne. En d'autres termes, les fins de lignes ne sont pas prises en compte quand l'interpréteur cherche à trouver le début et la fin de ces expressions WikiTexte. Quand l'interpréteur est en mode « en ligne », il reconnaît les syntaxes des expressions WikiTexte suivantes :
Techniquement, les autres expressions WikiTexte en mode en ligne ne sont reconnues que quand l'interpréteur est en mode en ligne. Toutefois, leurs balises d'ouverture vont déclencher le début d'un paragraphe, ce qui va automatiquement faire basculer l'interpréteur en mode en ligne. De ce fait, en pratique il est aussi simple de considérer que ces expressions sont reconnues par l'interpréteur aussi bien en mode bloc qu'en mode en ligne.
Pendant le traitement du texte inclus dans certaines de ces expressions WikiTexte, l'interpréteur ignorera les syntaxes WikiTexte. Mais pour le reste de ces expressions WikiTexte, l'interpréteur continuera l'analyse en mode en ligne du texte inclus, ce qui peut l'amener à rencontrer un contenu qui le fait basculer en mode bloc.
The Innerwiki Plugin enables TiddlyWiki to embed a modified copy of itself (an "innerwiki"). The primary motivation is to be able to produce screenshot illustrations that are automatically up-to-date with the appearance of TiddlyWiki as it changes over time, or to produce the same screenshot in different languages.
In the browser, innerwikis are displayed as an embedded iframe. Under Node.js Google's Puppeteer is used to load the innerwikis as off-screen web pages and then snapshot them as a PNG image.
This will give you a dialog to search for and pick existing tiddlers in the wiki. When you pick a tiddler it will be inserted as a WikiText link where the cursor is in the text field.
Pressing will give you [[Some link]]
It wil not insert: external web links or picture links.
This will give you a dialog to search for and pick existing image tiddlers in the wiki. When you pick a tiddler it will be inserted as a WikiText image link where the cursor is in the text field.
The insertafter operator requires at least one parameter which specifies the title to insert into the input list. A second parameter can be used to specify the title after which the new title should be inserted.
A suffix can also be used to specify A, the title after which the new title should be inserted, but this form is deprecated. Instead, the two-parameter form is recommended. If the two-parameter form is used, the suffixes start and end can be used to specify where the item should be inserted if A is not found.
after-title : (optional). Insert T after this title A in the input list.
after-title-variable : (optional). The name of a variable specifying A instead of the after-title parameter.
missing-location : (optional). Either start or end: where to insert T if A is not found in the list.
If the item A isn't present in the input list then the new item is inserted at the end of the list. Depuis : 5.2.3 The suffixes start and end can be spedified to control where the new item is inserted when A is not found. The suffix end is the default, inserting the new item at the end of the list. The suffix start will cause the new item to be inserted at the start of the list when A is not found.
Either parameter can be a string, a text reference or a variable
If A is specified as both a suffix and a parameter, the parameter takes precedence
The insertbefore operator requires at least one parameter which specifies the title to insert into the input list. A second parameter can be used to specify the title before which the new title should be inserted.
Depuis : 5.2.3
Using the suffix to specify B, the title before which the new title should be inserted, is deprecated. Instead, the two-parameter form is recommended. If the two-parameter form is used, the suffixes start and end can be used to specify where the item should be inserted if B is not found.
before-title : (optional). Insert T before this title B in the input list.
before-title-variable : (optional). The name of a variable specifying B instead of the before-title parameter.
missing-location : (optional). Either start or end: where to insert T if B is not found in the list.
If the item B isn't present in the input list then the new item is inserted at the end of the list. Depuis : 5.2.3 The suffixes start and end can be spedified to control where the new item is inserted when B is not found. The suffix end is the default, inserting the new item at the end of the list. The suffix start will cause the new item to be inserted at the start of the list when B is not found.
Either parameter can be a string, a text reference or a variable
If B is specified as both a suffix and a parameter, the parameter takes precedence
If you want to follow the steps side by side you can .
Follow these instructions when using TiddlyWiki as a standalone, single file wiki.
Open your TiddlyWiki in a browser
Create a backup of your current wiki file (just in case)
Open the
Click on the Plugins tab and then the
Get more plugins button
Click open plugin library to open the official plugin library
When the library listing is loaded:
Use the tab to select between plugins, themes and languages
Use the search box to search the plugin details
Click the install button to install a plugin
Save your TiddlyWiki
If a yellow warning bar appears at the top of the window, refresh the window so that TiddlyWiki completes installation of the plugin
Depuis : 5.1.22 It is no longer necessary to refresh TiddlyWiki when deleting plugins that support dynamic loading. See the PluginMechanism for more details
Including a plugin as an ordinary tiddler by drag and drop into the browser, will result in the plugin only being active in the browser
It will not be available under Node.js
Option 1:
Using a Node.js configuration option 1 is the most common one
It lowers maintenence, because all plugins can be updated in one go
Option 2:
Option 2 is preferred if you want to work with a fixed configuration
Plugin updates only effect the corresponding wiki
Option 3:
This option allows to add and start an edition without the need to overwrite an existing tiddlywiki.info file
It allows you to start any edition as a client-server edition, even if the tiddlywiki.info file didn't specify it.
Option 4:
Is the exact same mechanism used for a single-file wiki
This mechanism should only be used in a Node.js configuration for testing and debugging purposes, since the plugins are stored in the tiddlers/ directory
Follow these instructions when using TiddlyWiki with a client-server Node.js configuration:
Identify the plugins you want to install using the Plugins tab of (don't install the plugins from here, though)
Plugins are identified by their type (ie language, theme or plugin) and their publisher and title. For example, the plugin $:/plugins/tiddlywiki/internals is referred to as tiddlywiki/internals
Quit the server if it is running
Edit the tiddlywiki.info file (it is in JSON format) and locate the plugins, themes or languages section (see below)
Add entries corresponding to the plugins you wish to add
Take care to retain commas to separate items
Do not terminate the last item in a list with a comma
Enregistrer les modificationsTiddlyWiki sur Node.jsWindows
Internet Information Server (IIS) de Microsoft est le serveur web intégré de Windows. Il peut s'avérer utile d'héberger TiddlyWiki dans IIS afin de bénéficier des fonctionnalités de réécriture d'URL, d'hébergement de fichiers statiques ou de redémarrage automatique après un crash.
1. Activer IIS
Dans la barre de recherche Windows, saisir « Activer ou désactiver les fonctionnalités Windows ».
Cliquer sur l'icône « Activer ou désactiver les fonctionnalités Windows » qui apparaît dans les résultats de recherche.
Cocher la case Internet Information Services (IIS) puis cliquer sur le bouton Ok.
L'installation prend quelques minutes. Une fois terminée, cliquer sur le bouton Fermer
Notez l'emploi des guillemets autour du mot de passe, sous forme de codes HTML : "
Pour prendre en compte une modification des paramètres dans le fichier web.config ou une modification du code de l'application, vous devrez redémarrer le serveur IIS à l'aide du « Gestionnaire des services internet (IIS) »
Ouvrez un terminal de ligne de commande et saisissez :
npm install -g tiddlywiki
En cas d'erreur, il faudra peut-être relancer la commande en tant qu'administrateur :
sudo npm install -g tiddlywiki (Mac/Linux)
Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version
En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple 5.3.2-prerelease ; d'autres informations de débogage peuvent aussi apparaître).
Faites l'essai :
tiddlywiki monnouveauwiki --init server pour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveur
tiddlywiki monnouveauwiki --listen pour démarrer TiddlyWiki
Cliquez sur le bouton Enregistrer les modifications de la barre latérale, OU
tiddlywiki monnouveauwiki --build index
L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki sera disponible seulement dans le répertoire où vous l'avez installé.
Si vous utilisez Debian ou une distribution Linux dérivée de Debian et que vous recevez une erreur node: command not found alors que le paquet node.js est installé, vous devrez peut-être créer un lien symbolique entre nodejs et node. Consultez le manuel de votre distribution et de whereis pour créer un lien correctement. Voir le rapport d'erreur 1434 sur github.
Exemple pour Debian 8.0 : sudo ln -s /usr/bin/nodejs /usr/bin/node
Vous pouvez aussi installer d'anciennes versions de TiddlyWiki ainsi :
Les Tiddlers d'apprentissage s'adressent directement aux lecteurs et les guident à travers un processus. Le lecteur est aussi bien un débutant qu'un utilisateur moyen.
Ces tiddlers peuvent se subdiviser en :
Bienvenue
Qu'est-ce que TiddlyWiki et pourquoi m'en soucier?
Démonstration des points clés et avantages
Questions fréquemment posées
Exemples de TiddlyWiki en action
Information sur le projet lui-même
Tutoriel
Une présentation ordonnée de matériaux pour débutants
Chaque tiddler introduit une nouveauté ou un concept
Son contenu principal contient très peu de liens
Une section "En savoir plus" accessible à la fin peut proposer des liens connexes
Exercice
Accompagne un tiddler tutoriel
Solution obtenue sur demande
Comment ?
Une liste d'étapes numérotées pour effectuer une petite tâche spécifique
Concis, avec des liens vers les tiddlers référents si besoin
Toujours avec un préambule pour clarifier la nature de la tache
Peut contenir explications et commentaires similaires
Reste indépendant pour préserver la sobriété du tiddler référence
Les tiddlers d'apprentissage s'adressent directement au lecteur par l'emploie du "vous". Ils peuvent être raisonnablement cordiaux.
Mais ils évitent l'excès de langage académique, culturel, les références à l'actualité et les tentatives de l'humour,car ils peuvent dérouter ou même offenser le lectorat international. Ils évitent aussi de frustrer potentiellement le lecteur par des descriptions caractérisées de commodes ou faciles.
This document is an attempt to be a fairly comprehensive guide to recovering from what you did not mean to do when using git. It isn't that git is so complicated that you need a large document to take care or your particular problem, it is more that the set of things that you might have done is so large that different techniques are needed depending on exactly what you have done and what you want to have happen.
find the intersection of titles from previous runs with titles in this filter run
input
all titles from previous filter runs
output
the titles that are present in both the result of this filter run and the output from previous runs
The filter output from previous runs is set aside. The :intersection filter run is started with all tiddler titles as input. Once this latest filter run has completed, the latest output is compared to the set-aside output. A new output is produced that contains only titles that appeared in both the set-aside output and the latest output.
Filter Run Prefix ExamplesSyntaxe d'un filtreIntersection Filter Run Prefix
A B C D :intersection[enlist[C D E F]]
A B C D :intersection[enlist[A B C D]]
A B C D :intersection[enlist[E F G H]]
:intersection[enlist[A B C D]]
→ Using intersection in the first filter run is of little use. The result will always be empty.
Difference between + and :intersection
The + prefix should be thought of as an "AND" in formal logic, e.g. "give me all titles that satisfy condition A and condition B". But it's not suitable for all cases; if condition B uses a filter operator that replaces its input, then it will be difficult to use the + prefix. For example, if you wanted to find out what tags two tiddlers have in common, you might try to write a filter expression like:
But that won't work, because the second filter run will end up throwing away its input and replacing it with an input consisting of the single title [[compare Operator]]. So the result you'd get from that filter expression would be just the tags of the compare Operator tiddler.
For cases like this, the :intersection prefix is what you need. It takes the filter output so far, sets it aside, and starts the next filter run with all tiddler titles as input. Then once the latest filter run has completed, it takes the latest output, compares it to the set-aside output, and produces a new output that contains only titles that appeared in both the set-aside output and the latest output. So to get only the tags that the field Operator and compare Operator tiddlers have in common, you would write a filter expression like this:
Ceci décrit les bases de l'écriture d'un filtre de sélection d'un ensemble de tiddlers. Pour une présentation plus technique, voir Syntaxe d'un filtre.
Les filtres ne font rien par eux-même si vous vous contentez de les intégrer dans un tiddler. Il faut un contexte. Une manière facile d'expérimenter les filtres est de les saisir dans l'option Filtrer de l'onglet Recherche avancée.
Le plus simple des cas se présente lorsque vous savez exactement quels tiddlers vous recherchez. Saisissez chaque titre entre une paire de double crochets, un espace entre chacun :
[[Livre de recettes]] [[OeufsBrouillés]] [[Gateau aux pommes de moman]]
Vous pouvez omettre les crochets quand un titre ne contient aucun espace :
[[Livre de recettes]] OeufsBrouillés [[Gateau aux pommes de moman]]
La paire de double crochets est une abréviation de :
[title[OeufsBrouillés]]
... qui offre une syntaxe du modèle général de tous les filtres :
[operateur[paramètre]]
En l'occurence, voici comment sélectionner tous les tiddlers étiquetés Recipe :
[tag[Recette]]
Vous pouvez inverser la sélection en ajoutant le point d'exclamation ! juste avant l'opérateur. Par exemple, nous pouvons sélectionner tous les tiddlers sans l'étiquette Recette :
[!tag[Recette]]
Les tiddlers peuvent être filtrés par d'autres champs que les titres ou les étiquettes :
[field:convive[4]]
Cette exemple sélectionnera tous les tiddlers qui ont 4 dans leur champ convive.
Comme le mot "convive" n'est pas un opérateur filtre standard (et n'est pas près de le devenir), vous pouvez omettre le préfixe field: en toute sécurité :
[convive[4]]
Combinaisons
Les filtres que nous avons examinés jusqu'à présent ont chacun une étape. Mais vous pouvez exécuter plusieurs étapes ensemble comme ceci :
[tag[Végétarien]!tag[soupe]convive[4]]
Notez que la séquence entière est contenue dans une seule paire de crochets.
Un tiddler doit correspondre à toutes les étapes de la séquence. Ainsi l'exemple supra renvoie à toutes les recettes végétariennes (autre que soupes) pour 4 convives.
Une série de séquences séparée sélectionnera les tiddlers qui correspondent à l'une des séquences. Nous pouvons réutiliser ceci pour trouver les recettes pour 3, 4 or 5 convives :
[convive[3]] [convive[4]] [convive[5]]
Si nous voulons ignorer les recettes végétariennes pour 4 convives, nous formulerons ainsi :
Par défaut, chaque séquence prend en compte tous les tiddlers du wiki. Mais on peut utiliser le signe + pour ne tenir compte que des seuls tiddlers sélectionnés par les précédentes séquences :
Ceci sélectionne les recettes pour 3, 4 ou 5 convives, puis filtre celles qui correspondent uniquement aux végétariennes, et enfin trie ce qui reste dans l'ordre alphabétique des titres.
D'une façon similaire, nous pouvons utiliser le signe - pour extraire une séquence de tiddlers du résultat précédent. Ici nous sélectionnons toutes les recettes végétariennes exceptées deux :
Le paramètre de chaque étape que nous avons vu jusqu'à présent s'insérait entre crochets, signifiant un traitement littéral par TiddlyWiki. Mais deux autres formes de parenthèses sont possibles :
Les accolades {} indiquent que le paramètre est une Référence textuelle, et que sa valeur doit être recherchée dans un tiddler spécial. Par exemple, si nous avons un tiddler nommé Préférence dont le texte apparait être le mot Végétarien, nous pouvons dire
[tag{Préférence}]
est une alternative à [tag[Végétarien]]. Ce qui permet à 'préférence' d'évoluer dans le temps.
Les chevrons <> indiquent que le paramètre est le nom d'une variable dont la valeur sera utilisée en lieu et place. Ici, nous utilisons la variable intégrée currentTiddler au sein d'un filtre qui sélectionne tous les tiddlers dont le texte contient le titre du tiddler en cours :
Ceci décrit les bases de l'écriture d'un filtre de sélection d'un ensemble de tiddlers. Pour une présentation plus technique, voir Syntaxe d'un filtre.
Les filtres ne font rien par eux-même si vous vous contentez de les intégrer dans un tiddler. Il faut un contexte. Une manière facile d'expérimenter les filtres est de les saisir dans l'option Filtrer de l'onglet Recherche avancée.
Le plus simple des cas se présente lorsque vous savez exactement quels tiddlers vous recherchez. Saisissez chaque titre entre une paire de double crochets, un espace entre chacun :
[[Livre de recettes]] [[OeufsBrouillés]] [[Gateau aux pommes de moman]]
Vous pouvez omettre les crochets quand un titre ne contient aucun espace :
[[Livre de recettes]] OeufsBrouillés [[Gateau aux pommes de moman]]
La paire de double crochets est une abréviation de :
[title[OeufsBrouillés]]
... qui offre une syntaxe du modèle général de tous les filtres :
[operateur[paramètre]]
En l'occurence, voici comment sélectionner tous les tiddlers étiquetés Recipe :
[tag[Recette]]
Vous pouvez inverser la sélection en ajoutant le point d'exclamation ! juste avant l'opérateur. Par exemple, nous pouvons sélectionner tous les tiddlers sans l'étiquette Recette :
[!tag[Recette]]
Les tiddlers peuvent être filtrés par d'autres champs que les titres ou les étiquettes :
[field:convive[4]]
Cette exemple sélectionnera tous les tiddlers qui ont 4 dans leur champ convive.
Comme le mot "convive" n'est pas un opérateur filtre standard (et n'est pas près de le devenir), vous pouvez omettre le préfixe field: en toute sécurité :
[convive[4]]
Combinaisons
Les filtres que nous avons examinés jusqu'à présent ont chacun une étape. Mais vous pouvez exécuter plusieurs étapes ensemble comme ceci :
[tag[Végétarien]!tag[soupe]convive[4]]
Notez que la séquence entière est contenue dans une seule paire de crochets.
Un tiddler doit correspondre à toutes les étapes de la séquence. Ainsi l'exemple supra renvoie à toutes les recettes végétariennes (autre que soupes) pour 4 convives.
Une série de séquences séparée sélectionnera les tiddlers qui correspondent à l'une des séquences. Nous pouvons réutiliser ceci pour trouver les recettes pour 3, 4 or 5 convives :
[convive[3]] [convive[4]] [convive[5]]
Si nous voulons ignorer les recettes végétariennes pour 4 convives, nous formulerons ainsi :
Par défaut, chaque séquence prend en compte tous les tiddlers du wiki. Mais on peut utiliser le signe + pour ne tenir compte que des seuls tiddlers sélectionnés par les précédentes séquences :
Ceci sélectionne les recettes pour 3, 4 ou 5 convives, puis filtre celles qui correspondent uniquement aux végétariennes, et enfin trie ce qui reste dans l'ordre alphabétique des titres.
D'une façon similaire, nous pouvons utiliser le signe - pour extraire une séquence de tiddlers du résultat précédent. Ici nous sélectionnons toutes les recettes végétariennes exceptées deux :
Le paramètre de chaque étape que nous avons vu jusqu'à présent s'insérait entre crochets, signifiant un traitement littéral par TiddlyWiki. Mais deux autres formes de parenthèses sont possibles :
Les accolades {} indiquent que le paramètre est une Référence textuelle, et que sa valeur doit être recherchée dans un tiddler spécial. Par exemple, si nous avons un tiddler nommé Préférence dont le texte apparait être le mot Végétarien, nous pouvons dire
[tag{Préférence}]
est une alternative à [tag[Végétarien]]. Ce qui permet à 'préférence' d'évoluer dans le temps.
Les chevrons <> indiquent que le paramètre est le nom d'une variable dont la valeur sera utilisée en lieu et place. Ici, nous utilisons la variable intégrée currentTiddler au sein d'un filtre qui sélectionne tous les tiddlers dont le texte contient le titre du tiddler en cours :
Making lists of items plays a central role in working with TiddlyWiki. The following is a brief run-through of some of the more common techniques.
TiddlyWiki uses lists internally for many purposes so the word can have several meanings. Here we are concerned with displaying sequences of items, but not necessarily presented as a conventional bullet list.
Manually Typed Lists
WikiText
WikiText lists are manually typed lists that use a special character to specify what sort of list it is and how it should be displayed.
Examples include bullet lists created with asterisks (*) and numbered lists (#). Behind the scenes, WikiText lists are based on the standard <ul> and <li> HTML elements. For more information see Lists in WikiText.
* Greatest Movies of All Time
** Casa Blanca
** Pride and Prejudice and Zombies
Affichera ceci :
Greatest Movies of All Time
Casa Blanca
Pride and Prejudice and Zombies
Generated Lists
Lists can be automatically generated with the ListWidget using filters in which filter operators
specify criteria for selecting which tiddlers are desired as output. Shortcut macros are provided for some common types of list.
ListWidget
The ListWidget is the most powerful tool for creating lists. It allows the filtered output to be manipulated and styled into forms that may not seem to resemble lists at all, for example tables or complex texts. For more details, see ListWidget.
An example to show all tiddlers tagged with "HelloThere" might look like:
Discover TiddlyWiki Some of the things you can do with TiddlyWiki Ten reasons to switch to TiddlyWiki Examples History of TiddlyWiki What happened to the original TiddlyWiki? A Gentle Guide to TiddlyWiki Funding TiddlyWiki Open Collective
Even tiddlers themselves are made with the ListWidget. The ViewTemplate makes use of the ListWidget to fetch all specified templates that are used to show a tiddlers title, tags, text and more.
Filtered transclusion
The syntax for filtered transclusion {{{...}}} takes a filter as input and outputs a linked list of matching titles. You can also apply a template, for example:
Découvrez TiddlyWikiCertaines choses que vous pouvez faire avec TiddlyWikiDix raisons de passer à TiddlyWikiExemples d'utilisationHistoire de TiddlyWikiQu'est-il arrivé au TiddlyWiki d'origine ?Un mini-guide de TiddlyWikiFunding TiddlyWikiOpen Collective
list-links Macro
The list-links macro gives a preformatted list, typically a bullet list, in a more simplified way than by using the ListWidget. Behind the scenes it really is the ListWidget applying a default template to each list item.
list, list-before and list-after are all field names to control the position of tiddlers in a list. Fields are a way to add additional bits of structured information to a tiddler such as date, quantity, category, etc.
list and listed are filter operators to, respectively, select and find titles in lists.
Depuis : 5.1.20 exists as a variable (whether or not that variable has a non-blank value)
blank
Depuis : 5.1.20 is blank (i.e. is a zero length string)
draft
Depuis : 5.1.23 is a draft of another tiddler. Synonym for [has[draft.of]]
If C is anything else an error message is returned. Depuis : 5.1.14 if C is blank, the output is passed through unchanged (in earlier versions an error message was returned).
!is[tiddler] is a synonym for is[missing], and vice versa.
When is[missing] is the first operator in a run, its output is always empty. And when is[shadow] comes first, it outputs only those shadow tiddlers that have been overridden. This is because the initial input to a run contains only non-shadow tiddlers.
Use has[title] to match any tiddler title that is either a tiddler or a shadow tiddler.
The all operator is similar to is, but its scope is the whole wiki.
JavaScript est un langage de programmation introduit initialement sur les navigateurs comme une façon de scripter des pages web. Il était considéré au début comme un jouet pas très bien conçu, mais avec les années, il finit par être reconnu comme un langage puissant en tant que tel, et est très largement adopté dans les navigateurs et au-delà.
JavaScript ressemble à ça :
function surfaceDuCercle(rayon) {
return rayon * 2 * 3.141592653;
}
jsonindexes to retrieve the names of the fields of a JSON object, or the indexes of a JSON array
Properties within a JSON object are identified by a sequence of indexes. In the following example, the value at [a] is one, and the value at [d][f][0] is five.
jsonindexes to retrieve the names of the fields of a JSON object, or the indexes of a JSON array
jsonextract to retrieve a JSON value as a string of JSON
Properties within a JSON object are identified by a sequence of indexes. In the following example, the value at [a] is one, and the value at [d][f][0] is five.
If the object or array contains nested child objects or arrays then the values are retrieved recursively and returned flattened into a list. For example:
The jsonindexes operator is used to retrieve the property names of JSON objects or the index names of JSON arrays. See also the following related operators:
jsonget to retrieve the values of a property in JSON data
jsonextract to retrieve a JSON value as a string of JSON
Properties within a JSON object are identified by a sequence of indexes. In the following example, the value at [a] is one, and the value at [d][f][0] is five.
The jsontype operator is used to retrieve the type of a property in JSON data. See also the following related operators:
jsonget to retrieve the values of a property in JSON data
jsonindexes to retrieve the names of the fields of a JSON object, or the indexes of a JSON array
jsonextract to retrieve a JSON value as a string of JSON
JSON supports the following data types:
string - a Unicode string
number - a floating point number
boolean - Boolean value (true or false)
array - an array of values
object - an object of name/value pairs
null - a special type representing a missing value
Properties within a JSON object are identified by a sequence of indexes. In the following example, the value at [a] is one, and the value at [d][f][0] is five.
Keyboard Shortcut Descriptors are used by the KeyboardWidget and within Tiddlers tagged $:/tags/KeyboardShortcut to link actions with a keyboard combination
A Keyboard Shortcut Descriptor has the following format:
In order to make a shortcut editable through the Raccourcis clavier Tab in the $:/ControlPanel it's sufficient to create a tiddler $:/config/ShortcutInfo/my-shortcut, where the suffix is the reference used for the Keyboard Shortcut
Notes on wiki navigation
If you want to create keyboard shortcuts for navigation, there are two things to keep in mind:
If your shortcut uses Ctrl, you need to include $scroll="yes" in the ActionNavigateWidget's attributes otherwise the action will be ignored.
The keyboard-driven-input macro generates an input field or textarea that lets you cycle through a given list of entries with the Up and Down keys. Doing so, an entry gets selected and can be processed with further actions
Parameters
To create the input field or textarea, the keyboard-driven-input macro accepts all parameters of the EditTextWidget
The additional parameters are:
parameter
purpose
storeTitle
the title of the tiddler that stores the user input
selectionStateTitle
the title of the tiddler that stores the selected entry with a -primaryList or -secondaryList suffix to make it unique
inputAcceptActions
the actions that get processed when the user hits Enter
inputAcceptVariantActions
the actions that get processed when the user hits ctrl-Enter
inputCancelActions
the actions that get processed when the user hits Escape
configTiddlerFilter
a filter that specifies the tiddler that stores the first item-filter in its first-search-filter field and the second item-filter in its second-search-filter field
firstSearchFilterField
the field of the configTiddler where the first search-filter is stored. Defaults to first-search-filter
secondSearchFilterField
the field of the configTiddler where the second search-filter is stored. Defaults to second-search-filter
filterMinLength
the minimum length of the user input after which items are filtered
The keyboard widget allows ActionWidgets to be triggered by specific key combinations. There is also a shorthand for generating Messages via the message and param attributes.
Content and Attributes
The content of the <$keyboard> widget is rendered normally. The keyboard shortcuts only take effect when the focus is within the contained content.
Attribute
Description
actions
A string containing ActionWidgets to be triggered when the key combination is detected Depuis : 5.2.0 The variables: event-key, event-code and modifier are available for the actions
Key string identifying the key(s) to be trapped (see below)
class
A CSS class to be assigned to the generated HTML DIV element
tag
Depuis : 5.1.14 The html element the widget creates to capture the keyboard event, defaults to: » span when parsed in inline-mode » div when parsed in block-mode
Variables
Depuis : 5.2.0 The following variables are made available to the actions:
Variables
Description
event-key
The event-key variable contains the character, if possible. eg: 1. You can experiment with some settings at: Key Codes (Example)
event-code
The event-code variable contains a character description. eg: Digit1 instead of 1. Or Space instead of an empty string , which is hard to see
event-key-descriptor
The event-key-descriptor variable is available if the keyboard event captured was configured using a keyboard shortcut descriptor of the form ((my-shortcut)) which references a configuration tiddler.
modifier
The modifier Variable contains the Modifier Key held during the event (can be normal, ctrl, shift, alt or combinations thereof)
Key Strings
Key strings are made up of one or more key specifiers separated by spaces. Each key specifier is zero or more of the modifiers alt, shift, ctrl or meta followed by the name of a key, all joined with "+" plus or "-" minus symbols. Key names are either the letter or digit printed on the key (eg "a" or "1"), or one of the special keys backspace, tab, enter or escape.
For example:
A
shift+A
shift+escape
ctrl+enter
ctrl+shift+alt+A
The plugin library introduces a very simple mechanism like Tiddlywiki Official Plugin Library to let select among the published plugins and install any number of them you like.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists. The original site is missing, but a link to an archive is provided.
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
This instruction is based on Tiddlywiki single html file model, while it can use subfolder for extra materials like images, audios, videos, pdfs,... in separate folders.
This instruction is based on local edit, save and push to GitHub. It does NOT use the new GitHub Saver mechanism (requires TW 5.1.20+) which lets edit and save directly from Tiddlywiki!
TiddlyWiki for Scholars est une personnalisation de TiddlyWiki 5.0.13-beta, que j'ai écrite en pensant à la prise de notes à partir de lectures, mais qui peut servir à d'autres choses. L'idée est de montrer et de faciliter la création des données liées au tiddler courant sans quitter le tiddler.
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
This tutorial is aimed at giving you a basic foundation so that you can start using TiddlyWiki right away. Here we take a look at the technology behind Tiddlywiki, how to install it and create your first Tiddler.
En septembre 2004, j'ai donc publié une version préliminaire de TiddlyWiki. Il s'agissait de la plus petite application possible démontrant le concept : un simple fichier HTML de 48KB qui s'auto-engendrait.
L'inconvénient d'avoir écrit de cette manière la première version de TiddlyWiki, c'est que ça la rendait complètement impraticable pour l'édition — quand vous cliquiez sur « enregistrer les modifications », elle faisait apparaître une fenêtre montrant les données qui auraient été enregistrées s'il avait été possible d'écrire sur le système de fichiers depuis une page HTML.
Un grande partie des premiers commentaires sur TiddlyWiki étaient que c'était un outil sympathique, mais qu'il aurait été plus utile si on avait pu enregistrer correctement les modifications. J'étais plutôt frustré, car je tenais pour certaine l'impossibilité pour un fichier HTML tournant dans un navigateur d'enregistrer des modifications sur le système de fichiers local.
Quelques mois plus tard, j'ai repéré une extension Firefox expérimentale qui permettait à TiddlyWiki de sauvegarder les modifications depuis le navigateur. En examinant le code, je réalisai que l'API utilisée pour écrire sur le système de fichiers était en fait disponible pour les fichiers HTML ordinaires — pourvu qu'ils soient chargés depuis une URI de type file://.
J'adaptai le code Firefox dans le noyau de TiddlyWiki et j'ajoutai bientôt une fonctionnalité similaire pour Internet Explorer (en utilisant un ancien contrôle ActiveX que Microsoft distribuait avec Internet Explorer).
Habituellement, avec TiddlyWiki, le contenu complet de tous les tiddlers est intégré dans le fichier HTML principal. Le LazyLoading (chargement différé) fait référence à une technique qui intègre seulement les métadonnées dans le tiddler (en d'autres termes, tous les champs hormis le champ text), et demande le contenu au serveur quand il est requis.
Le Lazy Loading peut être utilisée dans deux configurations:
À l'exécution de TiddlyWiki sous Node.js, les tiddlers images peuvent être soumis au Chargement Allégé
The leaflet plugin is a (working) attempt to integrate the leaflet library in TiddlyWiki in order to display geographical purpose tiddlers.
For now <$leafmap> widget displays an interactive map. Select size, location and zoom, clustering distance, and background. You can display data : geojson, point(s), polygon(s) and/or polyline(s) directly or calling GeoTiddler(s). Tiddler can be called individually, by list or with a filter.
Fin 2011, j'ai progressivement senti que j'aurais plus de latitude hors de l'enceinte de British Telecom pour réaliser le potentiel de TiddlyWiki. D'un commun accord, je suis parti et j'ai commencé à travailler comme développeur indépendant, en me concentrant principalement sur une réincarnation de TiddlyWiki, qui pris la forme de TiddlyWiki5.
Depuis : 5.2.1 The $let widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible $set widget. It differs from the $vars widget in that variables you're defining may depend on earlier variables defined within the same $let.
Content and Attributes
The content of the $let widget is the scope for the value assigned to the variable.
Attribute
Description
{attributes}
Each attribute name specifies a variable name. The attribute value is assigned to the variable
Attributes are evaluated in the order they are written. Attributes with the same name are allowed. Each time a duplicate attribute is encountered, it will replace the existing value set by the earlier duplicate.
Note
Depuis : 5.2.4 There is no longer any restriction on using variable names that start with the $ character.
Examples
Consider a case where you need to set multiple variables, where some depend on the evaluation of others.
Using the $let widget, this situation may be handled in the following way:
\define helloworld() Hello world!
<$let target="MyTiddler" currentTiddler={{{ [<target>prefix[$:/settings/for/]] }}} settings={{!!text}} currentTiddler=<<target>> >
The settings for <<currentTiddler>> are: <<settings>>
</$let>
In contrast, here is the same example using the $set widget:
This widget differs from $vars in the following way:
Each variable's definition will be immediately available to all proceeding variables in the same let widget. This differs from vars, in which definitions which depend on some variable will always look to the widget's outer scope for a value.
This widget differs from $set in the following ways:
A fallback (also known as "emptyValue") cannot be specified
Filters cannot be used to produce a conditional variable assignment
The Levenshtein distance is a metric for measuring the difference between two strings. Informally, the Levenshtein distance between two strings is the minimum number of single-character edits required to change one string into the other.
TiddlyWiki created by Jeremy Ruston, (jeremy [at] jermolene [dot] com)
Copyright (c) 2004-2007, Jeremy Ruston
Copyright (c) 2007-2023, UnaMesa Association
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
In layman's terms, the license says that you can take TiddlyWiki and do anything you want with it without any license fee payment or other legal obligation to the creators of TiddlyWiki or anyone else. The quid pro quo is that there is no warranty or guarantee with open source projects like TiddlyWiki. You can't sue the contributors to TiddlyWiki for any loss or damage due to the use of TiddlyWiki: even if your data is lost due to a tragic chain of circumstances that involves TiddlyWiki.
You are respectfully requested that to make an attribution to the project, but there's no obligation to do so.
For the avoidance of doubt, any information that you choose to store within your own copy of TiddlyWiki remains yours; using TiddlyWiki to publish content doesn't change whatever rights you may have to that content.
The lingo macro relates to the translation of TiddlyWiki's user interface into other languages. It returns a piece of text in the user's currently selected language.
Translatable text is supplied by language plugins containing tiddlers with specific titles that start with $:/language/.
Parameters
title
The title of the shadow tiddler that contains the text. The prefix $:/language/ is added automatically
The content of the <$linkcatcher> widget is displayed normally.
Attribute
Description
to
Optional title of the tiddler to be set to the title of the navigated tiddler
message
Optional identifier for a widget message to be sent when a navigation is caught
set
Optional title of the tiddler to be set to a specified value when navigation occurs
setTo
Value to be assigned by the set attribute
actions
Actions to be performed when a link is caught. Within the action string, the variable "navigateTo" contains the title of the tiddler being navigated. Depuis : 5.1.23 the modifier variable lists the modifier keys that are pressed when the action is invoked. The possible modifiers are ctrl, ctrl-alt, ctrl-shift, alt, alt-shift, shift and ctrl-alt-shift
Depuis : 5.2.0 For more complex use cases involving trapping the tm-navigate message consider the MessageCatcherWidget which provides greater flexibility
L'une des aptitudes clés du WikiTexte est sa capacité à créer des liens vers d'autres mémos (appelés tiddlers) ou vers des sites externes. Il existe plusieurs moyens de les mettre en œuvre.
Liens manuels
Lien vers un tiddler par son titre :
[[Titre de Tiddler]]
Pour changer le texte affiché par le lien :
[[Texte à afficher|Titre du Tiddler]]
Les liens peuvent aussi être créés à l'aide de la barre d'outils d'édition. Cliquez sur le bouton lien, puis recherchez et sélectionnez un tiddler.
Lien en « notation chameau »
Pour les tiddlers dont le titre respecte les règles de la notation chameau, saisir leur titre sans l'encadrer entre doubles crochets suffit à créer automatiquement un lien.
Il est possible de neutraliser un lien en le préfixant avec le symbole ~. Par exemple :
* ~HelloThere n'est pas un lien
* ~http://google.com/ n'est pas un lien
Affichera ceci :
HelloThere n'est pas un lien
http://google.com/ n'est pas un lien
Code HTML correspondant :
<ul><li>HelloThere n'est pas un lien</li><li>http://google.com/ n'est pas un lien</li></ul>
Liens externes
Pour inclure un lien vers une ressource Web externe comme un site ou un fichier, il est nécessaire de saisir son URLcomplète, en incluant son sigle URI, par exemple un protocole comme http://, file:// ou mailto: :
https://tiddlywiki.com/
[[TW5|https://tiddlywiki.com/languages/fr-FR/index.html]]
[[Envoyez-moi un courriel|mailto:moi@ici.net]]
[[Ouvrez le fichier|file:///c:/users/moi/index.html]]
Pour que cette syntaxe fonctionne, l'URL doit être reconnaissable en tant qu'URL. Dans le cas contraire elle est interprétée comme un titre de tiddler. Par conséquent, pour créer un lien vers une ressource localisée avec un chemin relatif, il faut utiliser la syntaxe étendue :
[ext[Ouvrir le fichier|index.html]]
[ext[Ouvrir le fichier|./index.html]]
[ext[Ouvrir le fichier|../README.md]]
[ext[Ouvrir le fichier|c:\users\moi\index.html]]
La syntaxe étendue fonctionne aussi avec les URL complètes, même si dans ce cas elle n'est pas nécessaire :
[ext[https://tiddlywiki.com/]]
[ext[TW5|https://tiddlywiki.com/languages/fr-FR/index.html]]
[ext[Envoyez-moi un courriel|mailto:moi@ici.net]]
[ext[Ouvrez le fichier|file:///c:/users/moi/index.html]]
Vous pouvez aussi utiliser la syntaxe étendue pour forcer l'interprétation en tant que lien externe :
[ext[Donnez|bitcoin:1aabbdd....?amount=0.001]]
Personnalisation des liens
Voir le LinkWidget pour plus de détails sur le widget sous-jacent utilisé pour implémenter les liens des tiddlers, et notamment les macros qui peuvent être utilisées pour personnaliser son comportement.
Génération de liens dynamiques
Les Liens en WikiTexte ne se prêtent pas bien à la création de liens dynamiques. C'est parce que ce lien WikiTexte :
<$link to="Linking in WikiText">
<$text text="lien vers moi-même"/>
</$link>
Comme le titre du lien ("lien vers moi-même") et la cible du lien ("Linking in WikiText") sont utilisés en tant qu'attributs de widgets, aucune expansion de WikiTexte ne peut avoir lieu.
Par exemple, une tentative d'utilisation d'une référence et d'une variable pour générer un lien dynamique comme ceci :
⚠ Attention : Ne faites pas comme ça !
[[{{!!mon_texte}}|<<currentTiddler>>]]
revient à essayer d'utiliser les widgets Lien et Texte ainsi :
ce qui ne fonctionnera pas comme espéré. Le contenu des attributs est placé entre guillemets et donc traité comme une valeur littérale protégée contre l'expansion WikiTexte. Il sera donc affiché ainsi :
Dans TiddlyWiki les liens ancrés peuvent cibler des points particuliers et des sections distinctes à l'intérieur même de tiddlers, qui aident le lecteur à naviguer dans le contenu des tiddlers les plus longs.
Each input title is processed in turn. The corresponding tiddler's list of links is generated, in the order in which they appear in the tiddler's text, and dominantly appended to the operator's overall output.
The link widget generates links to tiddlers. (Use the HTML <a> element to generate external links).
Content and Attributes
The content of the link widget is rendered within the <a> tag representing the link. If the content is empty then the title of the target tiddler is rendered as the default, for example:
<$link/> is equivalent to <$link to=<<currentTiddler>>><$view field="title"/></$link>
<$link to="HelloThere"/> is equivalent to <$link to="HelloThere">HelloThere</$link>
Attribute
Description
to
The title of the target tiddler for the link (defaults to the current tiddler)
This causes the tooltip to be the tooltip field of the target tiddler. If the field isn't present, then the title is used instead.
CSS Classes
The link widget automatically determines and applies the following classes to links:
tc-tiddlylink - applied to all links
tc-tiddlylink-external - applied to external, non-tiddler links
tc-tiddlylink-internal - applied to tiddler links
tc-tiddlylink-missing - applied to tiddler links where the target tiddler doesn't exist
tc-tiddlylink-resolves - applied to tiddler links when the target tiddler does exist
Use the class attribute to specify additional css classes, or overrideClass to apply only that but not the above defaults, e.g. when used in a LinkCatcherWidget:
*<$link class="example">Here</$link> the `example` class is added.
*<$link overrideClass="example">Here</$link> only the `example` class applies.
*<$link overrideClass="">Here</$link> no class is set.
Depuis : 5.1.15 If tv-filter-export-link is defined it is interpreted as a filter that converts the target tiddler title to the href value
If tv-wikilink-template is defined it is treated as a specialised macro body that can perform limited conversion of the target tiddler title to the href value
Otherwise, the target tiddler title is URI encoded to create the href
R can reference either a field or a property. See TextReference for the syntax.
If neither is specified, the list field is used by default. So [list[T]] outputs the titles listed in the list field of tiddler T.
If R consists of only a field or a property, the tiddler part of the reference defaults to the current tiddler. So [list[!!tags]] outputs the titles listed in the tags field of the current tiddler.
The list-links-draggable macro renders the ListField of a tiddler as a list of links that can be reordered via drag and drop.
Parameters
tiddler
The title of the tiddler containing the list
field
The name of the field containing the list (defaults to list)
emptyMessage
Optional wikitext to display if there is no output (tiddler is not existed, field is not existed or empty)
type
The element tag to use for the list wrapper (defaults to ul)
subtype
The element tag to use for the list items (defaults to li)
class
Optional space separated classes to add to the wrapper element
itemTemplate
Optional title of a tiddler to use as the template for rendering list items
If the itemTemplate parameter is not provided then the list items are rendered as simple links. Within the itemTemplate, the currentTiddler Variable refers to the current list item.
The list-tagged-draggable macro renders the tiddlers with a particular tag as a list of links that can be reordered via drag and drop.
Parameters
tag
The title of the tag
subFilter
An optional subfilter to filter out unwanted items (eg !tag[done])
itemTemplate
Optional title of a tiddler to use as the template for rendering list items
emptyMessage
Optional wikitext to display if there are no tiddlers with the specified tag
Note that the ordering is accomplished by assigning a new list to the list field of the tag tiddler. Any list-before or list-after fields on any of the other tiddlers carrying the tag are also removed to ensure the list field is respected.
If the itemTemplate parameter is not provided then the list items are rendered as simple links. Within the itemTemplate, the currentTiddler Variable refers to the current list item.
Each input title is processed in turn. A list of tiddlers whose F field mentions it is generated (in no particular order) and dominantly appended to the operator's overall output.
Tous les paramètres sont optionnels avec des valeurs par défaut sûres, et peuvent être spécifiés dans n'importe quel ordre. Les paramètres reconnus sont les suivants :
host - nom ou adresse de machine hôte à laquelle sera attaché le service (par défaut "127.0.0.1", autrement dit "localhost")
path-prefix - préfixe optionnel pour les noms de chemin
port - numéro de port sur lequel écouter ; une valeur non numérique est interprétée comme un nom de variable d'environnement dont sera extrait le numéro de port (par défaut à "8080")
credentials - chemin vers le fichier CSV d'autorisations (relativement au dossier du wiki)
anon-username - nom d'utilisateur qui servira à signer les modifications si l'utilisateur est anonyme
username - nom d'utilisateur optionnel pour l'authentification basique
password - mot de passe optionnel pour l'authentification basique
authenticated-user-header - nom d'en-tête optionnel à utiliser pour les authentifications de confiance
readers - liste de personnes de confiance autorisées à lire ce wiki, séparées par des virgules
writers - liste de personnes de confiance autorisées à modifier ce wiki, séparées par des virgules
csrf-disable - donner la valeur "yes" pour désactiver les vérifications CSRF (vaut "no" par défaut)
sse-enabled - donner la valeur "yes" pour activer les événement envoyés par le serveur (valeur "no" par défaut)
root-tiddler - le tiddler à servir à la racine (par défaut "$:/core/save/all")
root-render-type - le type de contenu avec lequel le tiddler racine doit être rendu (par défaut "text/plain")
root-serve-type - le type de contenu avec lequel le tiddler racine doit être servi (par défaut "text/html")
tls-cert - nom de chemin du fichier de certificat TLS (relativement au dossier du wiki)
tls-key - nom de chemin du fichier de clé TLS (relativement au dossier du wiki)
debug-level - niveau de débogage optionnel ; mettre à "debug" pour voir le détail des requêtes (par défaut à "none")
gzip - donner la valeur "yes" pour activer la compression gzip pour certaines interactions http (par défaut à "no")
use-browser-cache - une valeur "yes" autorise le navigateur à mettre en cache les réponses pour économiser de la bande passante ("no" par défaut)
Pour plus d'informations sur la manière de donner accès à votre instance de serveur à l'ensemble de votre réseau local, ainsi que sur les risques éventuels en matière de sécurité, voir le tiddler WebServer sur tiddlywiki.com.
Le champ de tiddlerlist est une fonctionnalité optionnelle qui peut vous aider à structurer votre contenu. Sa valeur est une liste de titres, qui peut être utilisée de différentes façons :
Le champ list d'un tiddler utilisé comme tag détermine l'ordre des tiddlers portant ce tag – voir Étiqueter pour plus de détails
Vous pouvez créer des listes à puces à l'aide du caractère * () :
* Premier élément d'une liste
* Deuxième éléments d'un liste
** Un sous-élément
* Troisième élément d'une liste
Affichera ceci :
Premier élément d'une liste
Deuxième éléments d'un liste
Un sous-élément
Troisième élément d'une liste
Code HTML correspondant :
<ul><li>Premier élément d'une liste</li><li>Deuxième éléments d'un liste<ul><li>Un sous-élément</li></ul></li><li>Troisième élément d'une liste</li></ul>
Listes ordonnées
Les listes ordonnées utilisent # au lieu de * () :
# Premier élément
# Deuxième élément
# Troisième élément
* Liste Une
** Liste deux
**> Un bloc
**> Un autre bloc
* Liste trois
Affichera ceci :
Liste Une
Liste deux
Un bloc
Un autre bloc
Liste trois
Code HTML correspondant :
<ul><li>Liste Une <ul><li>Liste deux<blockquote><div>Un bloc</div><div>Un autre bloc</div></blockquote></li></ul></li><li>Liste trois</li></ul>
Les paragraphes dans les listes
Les entrées d'une liste sont séparées par des sauts de ligne, rendant impossible d'y inclure des sauts de lignes sans passer à l'entrée suivante. Deux contournements sont possibles.
En un, vous pouvez transclure dans le paragraphe le contenu d'un autre tiddler. Par exemple :
* Première entrée
* <$transclude tiddler="MonTiddler" mode="block"/>
* Troisième
En deux, vous pouvez utiliser la balise HTML "div" pour inclure un contenu multiligne. Par exemple :
# Étape 1
# Étape 2
# Étape 3<div>
Ici, le premier parmi plusieurs paragraphes. Notez que le double saut de ligne précédant ce paragraphe est pris en compte.
Et ici, le deuxième parmi plusieurs paragraphes.
</div>
# Étape 4
# Étape 5
# Étape 6
Le widget ListWidget affiche la suite de tiddlers qui correspondent au tiddler filtre. Il répond à de nombreux cas d'utilisation :
Affichage de listes personnalisées de liens, comme le menu latéral de TiddlyWiki5
Listes personnalisées, comme "tous les tiddlers étiquetés 'task' et non-étiquetés 'fait'"
Lister chacun des tags appliqués au tiddler
Manipuler le déroulé principal
Les tiddlers sont affichés en transcluant chacun tour à tour via un gabarit. Il existe plusieurs façons de spécifier le gabarit et de contrôler le comportement de la liste.
Se reporter à Listes imbriquées pour voir comment générer des listes groupées et imbriquées en utilisant le widget list.
Contenu et Attributs
Le contenu du widget <$list> est un gabarit optionnel à utiliser pour l'affichage de chaque tiddler de la liste. Autrement, le gabarit peut être spécifié comme titre du tiddler dans le gabarit attribut. En l'absence de directive, le gabarit par défaut affiche juste le titre du tiddler.
Le titre du tiddler gabarit pour transclure chaque tiddler de la liste. Si aucun gabarit n'est spécifié, Le corps du widget list sert de gabarit. En l'absence de corps, un simple lien vers le tiddler est renvoyé.
editTemplate
Un gabarit différent pour la modification des Ébauches de Tiddlers en mode édition
variable
Le nom d'une variable dans laquelle le titre de chaque tiddler listé est mémorisé. Par défaut currentTiddler
emptyMessage
Message à afficher quand la liste est vide
storyview
Nom optionnel du module responsable de l'animation/traitement de la liste
history
Le titre du tiddler contenant l'historique de navigation
Mode édition
Le widget <$list> peut afficher de façon optionnelle les tiddlers ébauche via un gabarit différent lors de l'édition, voir Mécanisme d'Ébauche.
attribut storyview
L'attribut optionnel storyview indique le nom du module qui anime les changements dans la liste (incluant la navigation). Le noyau intègre les animations (storyview) suivantes :
classic : affiche la liste comme une séquence ordonnée de tiddlers
zoomin : affiche juste le tiddler courant dans la liste, avec une animation zoom à la navigation entre les tiddlers
pop : rétrécit les éléments sur place
Afin que les storyviews s'animent correctement, chaque entrée de la liste doit être un élément du DOM en mode bloc unique.
Historique et navigation
L'attribut optionnel history indique le nom du tiddler utilisé pour tracer le tiddler en cours pour les besoins de la navigation. Quand le tiddler history change, l'affichage de la liste répond en demandant à listview de diriger la navigation jusqu'au nouveau tiddler. Voir Mécanisme Historique pour les détails.
Charge des tiddlers à partir de fichiers TiddlyWikiClassic 2.x.x
(.html), .tiddler, .tid, .json ou d'autres types de
fichiers. Le traitement appliqué aux fichiers entrants est déterminé par l'extension du fichier. Utilisez plutôt la commande import si vous devez spécifier explicitement le désérialiseur et l'encodage.
Par défaut, la commande load provoque une erreur si aucun tiddler n'est trouvé. L'erreur peut être supprimée en spécifiant le paramètre optionnel "noerror".
Pour charger des tiddlers à partir d'un fichier TiddlyWiki chiffré, vous devrez d'abord spécifier le mot de passe à l'aide de la commande password. Par exemple :
For those who use many tags or store many different topics in a common wiki the Locator plugin is a table of contents widget and an enhanced search engine that gives you the opportunity to filter results by related tags. Unlike table of contents, standard search and list of tags, this plugin offers these features in an organic, collaborative way.
The log widget is invisible. Any content within it is ignored. Note that the widget will log to the console both when it is first rendered and also every time it refreshes.
When the widget is rendered, the names and values of all attributes are logged to the JavaScript console.
In addition there are optional attributes that can be used:
Optional Attribute
Description
$$filter
All variables matching this filter will also be logged.
$$message
A message to display as the title of the information logged. Useful when several log widgets are used in sequence.
$$all
Set to "yes" to log all variables in a collapsed table. Note that if there is nothing specified to log, all variables are always logged instead.
Example
Here is an example of logging two variables:
<$log myVar=<<myVar>> otherVar=<<otherVar>>/>
To log all variables:
<$log />
To log two variables as well as all core variables (which start with tv-):
applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved. With a single parameter, the default field is "text" and the default index is "0". If a second parameter is provided, that becomes the target field or index.
P, T = prefix applied to input titles to yield title of lookup tiddler from which value is retrieved. Now accepts 1 or 2 parameters, see below for details
output
the lookup values corresponding to each lookup tiddler
The action of this operator is as follows with 1 parameter:
Apply the specified prefix to each input tiddler title, yielding a new list of tiddler titles
Transclude the value of the text field each of those tiddlers
Substitute the default value for missing or empty values
Return the list of values
Depuis : 5.2.2
The use of the :index second suffix changes the default lookup location from field: text to index: 0. This is used if no 2nd parameter is provided.
The action of this operator is as follows with 2 parameters:
If there are two parameters provided, use the second parameter as the target field or index.
Note
If there is only one parameter given, the filter checks for a second suffix equal to "index". If this suffix is found, the default target index is "0".
In all other cases, the default target field is "text".
Then:
Apply the specified prefix to each input tiddler title, yielding a new list of tiddler titles
Transclude the value of the target field or index
Substitute the default value for missing or empty values
This tiddler describes the different ways in which macros can be called.
Macro Call Transclusion Shortcut
To call a macro, place <<double angle brackets>> around the name and any parameter values.
<<mymacro param:"This is the parameter value">>
By default, parameters are listed in the same order as in the macro's definition. A parameter can be labelled with its name and a colon to allow them to be listed in a different order.
If no value is specified for a parameter, the default value given for that parameter in the macro definition is used instead. (If no default value was defined, the parameter is blank).
Each parameter value can be enclosed in 'single quotes', "double quotes", """triple double quotes""" or [[double square brackets]]. Triple double quotes allow a value to contain almost anything. If a value contains no spaces or single or double quotes, it requires no delimiters.
A more formal presentation of this syntax is also available.
The shortcut syntax expands to the $transclude widget with the $variable attribute specifying the name of the macro to transclude.
<$transclude $variable="mymacro" param="This is the parameter value"/>
The widget itself offers greater flexibility than the shortcut syntax, including the ability to specify parameter values.
Assigning Macro Calls to Attribute Values
The result of a macro can be directly assigned to an attribute of a widget or HTML element. The result of the macro is not wikified, but the parameter substitution is performed.
Pour appeler une macro, placez des <<doubles parenthèses en équerre>> autour de son nom et des valeurs de ses paramètres. ex : <<maMacro val1 val2 ... valn>>
Par défaut, les paramètres sont passés dans l'ordre fixé lors de la définition de la macro. Un paramètre peut être identifié par son nom, pour plus de clarté ou pour pouvoir les utiliser dans le désordre.
Si aucune valeur n'est fournie pour un paramètre, la valeur par défaut fixée lors de la définition de la macro est utilisée (si aucune valeur par défaut n'est définie, le paramètre est tout simplement vide).
Chaque valeur de paramètre peut être délimitée par des 'simples cotes', des "doubles cotes", des """doubles cotes triplées""" ou des [[doubles crochets]]. Les doubles cotes triplées permettent de passer à peu près toutes les valeurs. Si une valeur ne contient ni espace, ni simple ou double cotes, les délimiteurs sont inutiles.
Une description plus formelle de cette syntaxe est aussi disponible.
Cette syntaxe est une forme abrégée du widget $macrocall. Le widget en lui-même permet une plus grande flexibilité, incluant la capacité de transclure des valeurs de paramètres ou de les générer via des macros additionnelles.
Comme les macros sont de simples variables paramétrées, des valeurs de variables peuvent être insérées en faisant appel aux mêmes techniques.
En WikiTexte, nommer les paramètres lors de l'appel aux macros est toujours le choix le plus sûr par rapport à l'utilisation de valeurs anonymes. Ne pas utiliser le nom des paramètres peut avoir des effets indésirables perturbants. Imaginez par exemple que le premier paramètre d'une macro serve à spécifier le nom d'un tiddler d'état, et que le second soit destiné à préciser un tiddler gabarit. Si vous deviez par mégarde oublier de définir la valeur du premier paramètre ou vous tromper dans l'ordre des paramètres, au prochain appel de la macro (qui pourrait même avoir lieu en prévisualisant votre tiddler) votre gabarit pourrait être malencontreusement écrasé avec le contenu destiné au tiddler d'état.
Le nom de macro est une série de caractères sans espace, autres que ( ou >.
La liste de déclaration de paramètre (parametres) a la syntaxe suivante :
Le séparateur de paramètres (sep) est toute série de caractères différente d'un nom de paramètre (parametre.nom). Entre autre chose, cela comprend les virgules, les espaces et les sautsdeligne.
Un parametre.nom est une suite de lettres (A–Z, a–z), de chiffres (0–9), de tirets (-) de soulignés (_).
Chaque parametre a, respectivement, la syntaxe suivante :
La valeur par défaut d'un paramètre est spécifiée comme suit :
La définition de la suite se fait comme suit :
Si marque un saut de ligne.
Un code.extrait correspond à toute suite de caractère qui ne termine pas la définition de la macro. Ce qui veut dire qu'un extrait de code, s'il comporte une ligne unique, ne peut comporter de sautdeligne ou s'il occupe plusieurs lignes ne peut comporter de \end.
L'extrait de code peut contenir des ZoneRéservée en utilisant la syntaxe suivante:
This tiddler describes the different ways in which macros can be defined.
Macro Definition Pragma
Macros are created using the Pragma: \define at the start of a tiddler. The definitions are available in the rest of the tiddler that defines them, plus any tiddlers that it transcludes.
\define mymacro(param)
This is the macro text (param=$param$)
\end
Nested Macro Definitions
Macro definitions can be nested to any number of required levels by specifying the name of the macro in the \end marker. Nested macro definitions must appear at the start of the definition that contains them. For example:
Note that the textual substitution of macro parameters that occurs when the outer macro is rendered will apply to the nested definitions as well. That generally means that textual substitution of macro parameters should not be used within nested macros.
Parameters of nested macros can also be accessed via the <<__variablename__>> syntax. As ordinary variables, these parameters are available within nested child macros (and grandchildren etc).
Macro Definition with Set Widget
Macros are implemented as a special type of variable and so internally are actually defined with a $set widget.
<$set name="mymacro" value="This is the macro text">
...
</$set>
Note
that it is not currently possible to specify parameters when defining a macro with the $set widget.
The tag SystemTag: $:/tags/Macro/View is used to define macros that should only be available within the main view template and the preview panel.
The tag SystemTag: $:/tags/Macro/View/Body is used to define macros that should only be available within the main view template body and the preview panel.
Une macro est définie par l'utilisation du pragma\define. Comme tout pragma, il peut seulement prendre place au début d'un tiddler.
La première ligne de la définition indique le nom de la macro suivi de ses paramètres. Chaque paramètre a un nom, et de façon optionnelle une valeur par défaut utilisée si aucune valeur n'est passée lors de l'appel de la macro. Les lignes qui suivent contiennent le texte de la macro (càd l'extrait de code représenté par le nom de la macro), jusqu'à l'apparition du \end :
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Salut, Je suis $name$ et je vis à $address$.
\end
Vous pouvez éviter l'utilisation du marqueur final \end, en rédigeant toute la définition sur une seule ligne :
\define sayhi(name:"Bugs Bunny") Salut, Je suis $name$.
Une présentation plus formelle de cette syntaxe est aussi disponible.
Les extraits de code peuvent utiliser des Zones Réservées en paramètres. Il suffira de placer le nom du paramètre entre les signes dollar, comme $ceci$.
Il est aussi possible d'utiliser des Zones Réservées comme variables. Il suffira de placer le nom de la variable (ou du nom de la macro) entre les signes dollar entourés de parenthèses, comme $(ceci)$.
À la valeur actuelle du paramètre ou de la variable se substituera celle portée par le ZoneRéservée lors de l'appel de la macro :
\define say-hi-using-variables()
Salut, je suis $(name)$ et je vis à $(address)$.
\end
\define name() Bugs
Les macros peuvent être utilisées dans le tiddler où elles sont définies, ainsi que tous les tiddlers qui le transclus.
Pour étendre l'utilisation d'une macro à tous les tiddlers, définissez-la dans un tiddler étiqueté $:/tags/Macro.
Il est aussi possible de développer une macro dans un module JavaScript. Les macros JavaScript sont disponibles dans tous les tiddlers, et offrent un maximum de flexibilité.
On peut importer dans un tiddler les définitions de macros d'une sélection d'autres tiddlers en utilisant le widget $importvariables.
Macros parameters are handled in two different ways:
Textual substitution is always performed for each parameter before the macro contents is used
When the macro contents are wikified the parameters are made available as variables. The variable names are formed by wrapping the parameter name with double underscores
Somewhat confusingly, in some situations both of these mechanisms will occur; this is related to the pitfalls of using macros.
Textual Substitution of Parameters and variables
The following substitutions take place before the text of a macro is used:
The pattern $param$ is replaced with the value of the named parameter
The pattern $(variable)$ is replaced with the value of the named variable
The actual value of the parameter or variable is substituted for the placeholder whenever the macro is called:
\define say-hi-using-parameters(name,address)
Hi, I'm $name$ and I live in $address$.
\end
<<say-hi-using-parameters name:"Bugs" address:"Rabbit Hole Hill">>
Affichera ceci :
Hi, I'm Bugs and I live in Rabbit Hole Hill.
Here's an example using variable substitution:
\define say-hi-using-variables()
Hi, I'm and I live in .
\end
\define name() Bugs
<$let address="Rabbit Hole Hill">
<<say-hi-using-variables>>
</$let>
Affichera ceci :
Hi, I'm and I live in .
It is important to note that if the text being inserted contains any substitution tokens then they will in turn be processed. This can lead to unexpected results.
Accessing Parameters as Variables
When macros are wikified, the parameters can be accessed as variables with the name of the parameter wrapped with double underscores. For example, the parameter address would be accessed as the variable __address__.
Thus, the example above could also be expressed as:
\define say-hi-using-parameters(name,address)
Hi, I'm <<__name__>> and I live in <<__address__>>.
\end
<<say-hi-using-parameters name:"Bugs" address:"Rabbit Hole Hill">>
Affichera ceci :
Hi, I'm Bugs and I live in Rabbit Hole Hill.
Accessing parameters as variables only works in macros that are wikified and not, for example, when a macro is used as an attribute value.
Advantages of Accessing Parameters as Variables
The primary advantage of the technique is that it avoids the parameter value being substituted into the macro as a literal string, which in turn can help avoid issues with parameters that contain quotes.
For example, consider this macro. It invokes another macro using the single parameter as an argument for it:
The code above will fail if the macro is invoked with the argument containing triple double quotes (for example <<film-quote 'I quote thrice """ - see!?'>>). Using parameter variables offers a workaround:
In the early days of TiddlyWiki, macros were the best way of encapsulating snippets for reuse, and so they were used extensively. However, they have always suffered from some significant disadvantages that can give rise to errors and poor performance.
Depuis : 5.3.0 Macros have been joined by Procedures, Custom Widgets and Functions which together provide more robust and flexible ways to encapsulate and re-use code. It is now recommended to only use macros when textual substitution is specifically required.
Shortcomings of Textual Substitution
TiddlyWiki's handling of macro parameters is based on "textual substitution" which means that the string values of the parameters provided when calling a macro are plugged into the macro definition before it is wikified.
Here's a typical example of the approach in early versions of TiddlyWiki 5. The intention is to provide a macro that takes a single parameter of the title of the tiddler to view:
That works for simple cases like <<mymacro "HelloThere">> but is subtly brittle. For example, the macro above would fail with tiddler titles containing double closing curly braces. Trying to use it with the title foo}}bar would lead to the macro being expanded to the following invalid syntax:
<$codeblock code={{foo}}bar}}/>
As a result of this issue, for many years the TiddlyWiki 5 user interface failed if a variety of combinations of special characters were encountered in tiddler titles.
This issue has been mitigated over the years, particularly by providing access to the macro parameters as variables. However, for backwards compatibility, this was done without affecting the existing syntax, which required us to adopt the clumsy protocol of wrapping the parameter name in double underscores to get the name of the corresponding variable.
Performance of Global Macros
Global Macro Definitions defined with the SystemTag: $:/tags/Macro suffer from poor performance because every macro has to be parsed regardless of whether it is actually used.
Furthermore, the way that definitions are imported means that updating a tiddler tagged SystemTag: $:/tags/Macro will cause the entire page to be refreshed.
Le widget d'appel de macro propose une syntaxe alternative pour invoquer des macros. L'avantage de la forme de ce widget est de passer des paramètres de macro en attributs de widget, ce qui permet d'utiliser des indirections et d'affecter des valeurs de macro.
Par exemple, une macro appelée italicise ayant pour seul paramètre texte peut être invoquée de ces différentes façons :
<<italicise "Texte à mettre en italiques">>
<<italicise text:"Texte à mettre en italiques">>
<$macrocall $name="italicise" text="Texte à mettre en italiques"/>
<$macrocall $name="italicise" text={{Titre du tiddler contenant le Texte à mettre en italiques}}/>
<$macrocall $name="italicise" text=<<textMaker "Une autre macro pour générer du texte à italiciser">>/>
Vous pouvez examiner plusieurs exemples du widget d'appel de macro dans le noyau :
Une macro est un bout de texte auquel on donne un nom. Le WikiTexte utilise ce nom comme raccourci pour transclure le bout de texte. Ces transclusions particulières s'appellent des appels de macro, et chaque appel peut transmettre un ensemble différent d'arguments, qui se substituent à leur emplacement dans le bout de texte.
La plupart des macros sont en fait des variables paramétrées.
Elles sont définies en utilisant le pragma\define. (En coulisses, cette syntaxe est transformé en Widget set, donc les macros et les variables sont bien les deux faces de la même pièce.)
Le bout de texte et ses arguments sont traités comme de simple chaînes de caractères, sans interprétation du WikiTexte, au moins jusqu'à ce que le dernier emplacement ait été rempli et que l'appel de macro soit terminé. Cela signifie qu'une macro peut assembler et renvoyer la syntaxe complète d'un composant WikiTexte, comme un lien par exemple. (Voir Transclusion et substitution pour une discussion plus approfondie sur ce sujet.)
A l'intérieur d'un bout de texte lui-même, le seul balisage détecté est $nom$ (un emplacement pour le paramètre nom qui sera substitué par l'argument correspondant reçu au moment d'un appel de macro) et $(nom)$ (un emplacement pour une variable).
La macro dumpvariables liste toutes les variables (y-compris les macros) qui sont disponibles à cet endroit de l'arborescence des widgets.
Un widget $importvariables peut être utilisé pour copier une définition de macro vers une autre branche de l'arbre des widgets. TiddlyWiki utilise cette technique en interne pour implémenter des macros globales – c'est-à-dire des macros définies dans des tiddlers étiquetés $:/tags/Macro. (Le tag $:/tags/Macro/View est quant à lui utilisé pour définir des macros qui ne doivent être disponibles que dans le modèle de vue principal et le panneau de prévisualisation.)
Construit le tiddler $:/UpgradeLibrary pour la procédure de mise à jour.
La bibliothèque de mise à jour est formatée comme un tiddler de plugin ordinaire avec le type library. Elle contient un exemplaire de chacun des packs de plugins, thèmes et languages disponibles dans le répertoire de TiddlyWiki5.
Cette commande est prévue pour un usage interne ; elle n'a d'intérêt que pour les utilisateurs qui construisent une variante de la procédure de mise à jour.
--makelibrary <titre>
L'argument titre a pour valeur par défaut $:/UpgradeLibrary.
Hamlet: Do you see yonder cloud that's almost in shape of a camel?
Polonius: By the mass, and 'tis like a camel, indeed.
Hamlet: Methinks it is like a weasel.
Polonius: It is backed like a weasel.
Hamlet: Or like a whale?
Polonius: Very like a whale.
– Shakespeare
Modern English
Hamlet: Do you see the cloud over there that's almost the shape of a camel?
Polonius: By golly, it is like a camel, indeed.
Hamlet: I think it looks like a weasel.
Polonius: It is shaped like a weasel.
Hamlet: Or like a whale?
Polonius: It's totally like a whale.
– Shakespeare
Trekkie's Copy
Kirk: Do you see yonder cloud that's almost in shape of a Klingon?
Spock: By the mass, and 'tis like a Klingon, indeed.
Kirk: Methinks it is like a Vulcan.
Spock: It is backed like a Vulcan.
Kirk: Or like a Romulan?
Spock: Very like a Romulan.
– Trekkie
Use makepatches to generate the set of patches to transform Shakepeare's original into Modern English:
In the above example, the Map Filter Run Prefix is used to pass the patches information as a parameter to applypatches. Inside :map, currentTiddler is set to the input title (i.e. the previously generated patches).
The patch information from the Shakepeare texts can also be used to transform the Trekkie's Copy to a Modern English version:
The above examples used the character mode of makepatches. The word mode yields very similar results in this case, even when applied to the Trekkie's Copy.
It is better suited as a very fast algorithm to detect line-wise incremental changes to texts and store only the changes instead of multiple versions of the whole texts.
The difference algorithm operates in character mode by default. This produces the most detailed diff possible. In words mode, each word in the input text is transformed into a meta-character, upon which the algorithm then operates. In the default character mode, the filter would find two patches between "ActionWidget" and "Action-Widgets" (the hyphen and the plural s), while in words mode, the whole word is found to be changed. In lines mode, the meta-character is formed from the whole line, delimited by newline characters, and is found to be changed independent of the number of changes within the line.
The different modes influence the result when the patches are applied to texts other than the original, as well as the runtime.
The calculation in words mode is roughly 10 times faster than the default character mode, while lines mode can be more than 100 times faster than the default.
Cette démonstration montre comment utiliser SVG pour faire suivre un chemin incurvé à un texte transclu. Entrez du texte dans la zone çi-dessous pour essayer ; visualiser le code source pour voir examiner le fonctionnement.
Drag the link similar to $:/plugins/tiddlywiki/example to the browser window containing your TiddlyWiki
Import the new plugin shown in the $:/Import tiddler
Save your TiddlyWiki ()
If a yellow warning bar appears at the top of the window, refresh the window so that TiddlyWiki completes installation of the plugin
Depuis : 5.1.22 It is no longer necessary to refresh TiddlyWiki when deleting plugins that support dynamic loading. See PluginMechanism for more details
modify input titles by the result of evaluating this filter run for each item
input
all titles from previous filter runs
suffix
Depuis : 5.2.3flat to return all results from the filter run, If omitted (default), only the first result is returned.
output
the input titles as modified by the result of this filter run
Each input title from previous runs is passed to this run in turn. The filter run transforms the input titles and the output of this run replaces the input title. For example, the filter run [get[caption]else{!!title}] replaces each input title with its caption field, unless the field does not exist in which case the title is preserved.
Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like :map[{!!price}multiply{!!cost}] to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
The following variables are available within the filter run:
currentTiddler - the input title
..currentTiddler - the value of the variable currentTiddler outside the filter run.
index - Depuis : 5.2.1 the numeric index of the current list item (with zero being the first item in the list).
revIndex - Depuis : 5.2.1 the reverse numeric index of the current list item (with zero being the last item in the list).
length - Depuis : 5.2.1 the total length of the input list.
Filter runs used with the :map prefix should return at least the same number of items that they are passed. Any missing entries will be treated as an empty string. In particular, when retrieving the value of a field with the get Operator it is helpful to guard against a missing field value using the else Operator. For example [get[myfield]else[default-value]....
Filter Run Prefix ExamplesSyntaxe d'un filtreMap Filter Run Prefix
Replace the input titles with the caption field if it exists, otherwise preserve the input title:
[tag[Widgets]] :map[get[caption]else{!!title}]
The above example is equivalent to [tag[Widgets]] :map[{!!caption}!is[blank]else{!!title}]. Note that referencing a field as a text reference such as {!!caption} returns an empty string for a non-existent or empty caption field. Therefore a check for is[blank] is needed before the else operator
For each title in a shopping list, calculate the total cost of purchasing each item:
Without the flat suffix the :map filter run only returns the first result for each input title
Comparison between :map with and without the flat suffix
The :map filter run will return at least as many outputs as given in the input. By default one input item will result in exactly one output item. When the filter run transforms an input item into an empty result, the output for that item will be an empty string. When the filter run transforms an input item into multiple items, only the first item will appear in the output. This behavior can be overridden by providing the flat suffix. The flat suffix will cause all the items to appear in the output.
Comparison between :map and :and/+ filter run prefixes
The functionality of the :map filter run prefix has some overlap with the :and prefix (alias +). They will sometimes return the same results as each other. In at least these cases, the results will be different:
The :and filter run can modify the number of items (either increase or decrease). The :map run will never alter the number of items.
The number of items in the :and filter run will also decrease due to de-duplication. The :map run will not de-duplicate.
Explicit references to the "currentTiddler" variable will behave differently
Implicit references to the "currentTiddler" using TextReference will behave differently.
Depuis : 5.1.20The mathematics filter operators allow numerical calculations to be performed within filters.
Using mathematics operators
The mathematics operators interpret their arguments as numbers according to the following rules:
Any non-numeric characters after a valid number are ignored (e.g. 28px is interpreted as the number 28)
If the argument cannot be interpreted as a number, the value 0 is used (e.g. foo is interpreted as the number 0)
The special values Infinity and -Infinity can be used to represent positive and negative infinity respectively
Some filter operators remove duplicate items which can cause unexpected results when using the mathematics operators. See Dominant Append for details.
The mathematics operators take three different forms:
Unary operators apply an operation to each number in the input list (e.g. negate, truncate, sign)
Binary operators apply an operation and operand to each number in the input list (e.g. add, multiply, remainder)
Reducing operators apply an operation to all of the numbers in the input list, returning a single result (e.g. sum, product)
Operations Combination
Operations can be combined by concatenating them while merging the inner ][ characters.
Complex operations will sometimes need to be split up into separate filters. For example, to compute the average length of the text field of tiddlers tagged "HelloThere":
<$set name="number-of-tiddlers" value={{{ [tag[HelloThere]count[]] }}}>
Average length of <$text text=<<number-of-tiddlers>>/> tiddlers tagged <<tag "HelloThere">>: <$text text={{{ [tag[HelloThere]get[text]length[]sum[]divide<number-of-tiddlers>fixed[3]] }}}/>
</$set>
Affichera ceci :
Average length of 9 tiddlers tagged Bienvenue !: 1379.444
An experimental MathJax plugin for TiddlyWiki version 5. As Martin says, the implementation is a bit of a hack but may be useful until we have a better alternative.
Welcome. I have created plugin for TiddlyWiki 5 which allows you to use MathJax (math in TeX and MathML) inside TiddlyWiki 5. It's unofficial plugin and it doesn't follow general policy of TiddlyWiki as stand-alone solution but it works. So you can use it if you want.
Rencontres locales d'enthousiastes de TiddlyWiki tout autour du monde :
OXTWIG, le groupe d'intérêt TiddlyWiki d'Oxford des rencontres mensuelles à Oxford, UK pour partager des expériences sur l'utilisation de TiddlyWiki
Si vous êtes un enthousiaste de TiddlyWiki veuillez réfléchir au lancement d'un TWIG local, c'est un excellent moyen de faire part au monde de l'utilisation de TiddlyWiki
The message catcher widget traps messages dispatched within its child content, and allows invoking a series of ActionWidgets in response to those messages.
Content and Attributes
The content of the <$messagecatcher> widget is displayed normally.
Attribute
Description
{any attributes starting with $}
Each attribute name (excluding the $) specifies the name of a message, and the value specifies the action string to be invoked
type
Name of the message be trapped, for example "tm-scroll" or "tm-navigate". The type and actions attributes can be useful when the type of event needs to be specified via a variable or text reference
actions
Action string to be invoked when a matching message is trapped. Must be used in conjunction with the type attribute
Variables
The message catcher widget sets the following variables within each action string:
Variables
Description
event-*
All string-based properties of the event object, with the names prefixed with event-
list-event
A list of the names of each the string-based properties of the event object (the names are not prefixed with event-)
event-paramObject-*
All string-based properties of the event.paramObject object, with the names prefixed with event-paramObject-
list-event-paramObject
A list of the names of each the string-based properties of the event.paramObject object (the names are not prefixed with event-paramObject-)
modifier
For messages that originated with browser events, the modifier keys that were pressed when the event was fired. The possible modifiers are normal (no modifiers), ctrl, ctrl-alt, ctrl-shift, alt, alt-shift, shift and ctrl-alt-shift
Example
\define actions()
<$action-log/>
\end
<$messagecatcher $tm-navigate=<<actions>>>
Click on [[this link]] to fire an action. See the browser JavaScript console for the output
</$messagecatcher>
Affichera ceci :
Click on this link to fire an action. See the browser JavaScript console for the output
Message handler widgets are those widgets which can react to one or more widget messages.
Widget messages are similar to low-level DOM events, except they are higher-level and specific to TiddlyWiki. To handle DOM events see the EventCatcherWidget
The following message handler widgets are provided:
Les messages Widget sont générés par les widgets en réponse aux actions utilisateur. Ils parcourent l'arbre widget jusqu'à ce qu'ils soient traités par un ascendant widget.
Les messages suivants sont implémentés dans le noyau :
The Mobile Drag And Drop Shim Plugin provides a "shim" that enables HTML 5 compatible drag and drop operations on mobile browsers, including iOS and Android. The shim was created by Tim Ruffles and is published at https://github.com/timruffles/ios-html5-drag-drop-shim.
Within the action string of the DroppableWidget, the startactions and endactions of the DraggableWidget, the action string of the ButtonWidget and the action string of the LinkCatcherWidget and the EventCatcherWidget, the modifier variable contains the modifier key(s) held during the drag, click or other event.
Possible key combinations are listed in the table below.
The variable contains a string that identifies the keys:
Modifier Key
Variable Content
meta
meta
ctrl
ctrl
alt
alt
shift
shift
meta+shift
meta-shift
meta+ctrl
meta-ctrl
meta+alt
meta-alt
ctrl+shift
ctrl-shift
alt+shift
alt-shift
ctrl+alt
ctrl-alt
meta+ctrl+shift
meta-ctrl-shift
meta+ctrl+alt
meta-ctrl-alt
meta+alt+shift
meta-alt-shift
ctrl+alt+shift
ctrl-alt-shift
meta+ctrl+alt+shift
meta-ctrl-alt-shift
no modifier (normal click / drag)
normal
Some operating systems may intercept the meta key so it is never detected
Modifier keys held while clicking the button above:
The widgets ActionSetFieldWidget and ActionListopsWidget can manipulate named properties of data tiddlers by indicating the name of the property in the $index attribute.
To create or modify a named property with ActionSetFieldWidget, provide a $value attribute
To delete a named property with ActionSetFieldWidget, omit the $value attribute.
ActionListopsWidget assigns the named property the list constructed through its $filter and $subfilter attributes.
Un module dans TiddlyWiki5 est un tiddler contenant du JavaScript exécutable, de type application/javascript et dont le champ module-type correspond au ModuleType du module.
Voir dans l'onglet Info du panneau de contrôle, l'option Avancé, puis cliquer sur $Modules chargés pour les listes des modules chargés.
Depuis : 5.2.0The modules filter allows two optional operands. When both are specified, it returns the modules with the module property specified in the first operand which has the value in the second operand.
Le champ module-type d'un module JavaScript est une chaine identifiant le type de module. Ci-après la liste des types de module utilisés dans ce wiki :
allfilteroperator
Un sous-opérateur pour l'opérateur de filtre all.
animation
Animations pouvant être utilisées par le RevealWidget.
authenticator
Définit comment les requêtes sont authentifiées par le serveur HTTP intégré.
bitmapeditoroperation
Une opération intégrée à la barre d'outils de l'éditeur de bitmap.
command
Commandes qui peuvent être exécutées en mode Node.js.
MultiTiddlerFiles allow multiple tiddlers to be concisely represented in a single text file.
The goals of this format are:
To be easy to type and easy to read
Optimised for single line strings
To allow common fields or tags to be shared within groups of tiddlers
To be simple to process with external tools
MultiTiddlerFiles have the extension multids. The file is structured as a block of shared fields followed by a blank line. The rest of the file is a sequence of comments and tiddlers. Tiddlers are specified by their title, followed by a colon, at least one space character, and then the rest of the line is the text field for the tiddler.
For example:
title: $:/language/ControlPanel/
tags: strings
modifier: JoeBloggs
Basics/Caption: Basics
# This is a comment
Basics/Version: ~TiddlyWiki Version
A named filter run prefix can precede any run of a filter expression in place of a single-character prefix (+, - and so on). To create a new filter run prefix, create a Javascript module with a module-type of filterrunprefix.
Depuis : 5.1.18 Most TiddlyWikiCommands use a position-based system for their parameters where each parameter must be listed in the precise order defined by the command. Some of the more complex commands offer an alternative scheme of named command parameters. For example, here we provide two parameters named "port" and "host":
--listen port=8090 host=0.0.0.0
Note that the order of the parameters does not matter.
Using special characters within a parameter requires quoting. Unix, Linux and the Mac use single quotes, and Windows uses double quotes:
Dans le mode de déroulé par défaut « classic », les tiddlers ouverts sont affichés verticalement dans une colonne appelée « cours du déroulé ». Il existe plusieurs façons de parcourir le déroulé — autrement dit, de rebondir d'un tiddler ouvert à l'autre.
Une façon évidente consiste à faire défiler la page de bas en haut à l'aide de la barre de défilement du déroulé sur la droite.
On notera que lorsque le cours du déroulé et la barre latérale s'étendent l'un et l'autre sous l'écran visible, deux barre de défilement apparaissent. La barre de défilement extérieure, soit la plus à droite, contrôle le cours du déroulé. La barre de déroulement intérieure contrôle la barre latérale.
Une manière de procéder un peu maladroite mais souvent tentée par les nouveaux utilisateurs consiste à fermer les tiddlers un par un jusqu'à retrouver le tiddler qu'ils cherchent.
Fermer un tiddler quelconque en haut ou au milieu du déroulé fera que tous les tiddlers situés en dessous remonteront le cours du déroulé. Le tiddler situé juste en dessous de celui que vous venez de fermer remontera d'un cran pour prendre sa place.
Fermer le tiddler tout en bas du déroulé amènera le bas du tiddler situé juste au-dessus de lui dans le champ de vision.
La meilleure approche consiste à utiliser l'onglet Ouverts dans la barre latérale pour cliquer directement sur le tiddler ouvert vers lequel vous souhaitez vous déplacer.
L'onglet 'Ouverts' contient la liste de tous les tiddlers ouverts. Vous pouvez cliquer sur n'importe quel tiddler de la liste pour rebondir vers lui, ou cliquer sur le 'x' situé à côté pour le fermer. Il existe également un bouton 'Tout fermer' au bas de la liste des tiddlers ouverts.
The navigator widget manipulates the current store, the story list and history lists in response to various Messages.
Content and Attributes
The navigator widget displays any contained content, and responds to Messages dispatched within it.
Attribute
Description
story
Name of the tiddler containing the story list to be manipulated
history
Name of the tiddler containing the history list to be manipulated
openLinkFromInsideRiver
Determines the location for opening new tiddlers from links within the story river: at the top or bottom of the story river, or above or below the current tiddler
openLinkFromOutsideRiver
Determines the location for opening new tiddlers from links outside the story river: at the top or bottom of the story river
relinkOnRename
Depuis : 5.1.14 Determines if tags in other tiddlers are renamed if the tiddler title changes. yes or no. default: no
Widget Messages
The following Messages are handled by the navigator widget:
Each input title is processed in turn, and its successor is located in the list field and appended to the output. If a title is not listed in the field, or is the last title there, then it contributes nothing to the output.
Node.js est une application téléchargeable sur votre ordinateur PC, Mac ou Linux, qui vous permet d'exécuter des programmes JavaScript. Contrairement aux programmes JavaScript s'exécutant dans un navigateur, le code tournant sur Node.js dispose d'un accès complet au système de fichiers et aux autres ressources de l'ordinateur, ce qui lui permet mener à bien des tâches traditionnellement dévolues à des langages comme Java, PHP et Python. Voir http://nodejs.org pour plus de détails.
Dans le cas de TiddlyWiki, Node.js permet de profiter d'un même code principal capable de tourner aussi bien dans le navigateur que sur le serveur, ce qui accroît encore sa souplesse d'utilisation.
Pour les utilisateurs finaux, le mode Node.js n'est pas plus compliqué à utiliser que le mode intégré au navigateur web, mais il donne accès à des fonctions puissantes, notamment la possibilité d'exécuter TiddlyWiki en tant que serveur web auquel vous pouvez vous connecter depuis d'autres appareils.
Version 5.0.11-beta includes some changes that can break content from earlier releases of TiddlyWiki 5.
Command line changes
Previously, commands that generate output files would interpret the specified path to the file as being relative to the current working directory. So, for example, the following command would write index.html to the current directory:
In 5.0.11-beta this behaviour has changed, and now the specified filename is resolved relative to an output folder within the TiddlyWikiFolder. So the command above will now write the file index.html to mywiki/output/index.html.
You can override this behaviour with the OutputCommand. For example, to generate the index.html file within the current directory:
A further change is that the --rendertiddlers command now clears the output folder before it writes any files. This means that any previous --rendertiddler commands to the same folder will have their output deleted.
Changed parsing rules for content of HTML elements
Version 5.0.8-beta marks a change in the way that TiddlyWiki determines whether to parse the content of an HTML element or widget in block mode or inline mode.
In block mode, TiddlyWiki parses text into paragraphs, creating <p> tags to wrap them. It also recognises block syntax like headings, lists and tables.
In inline mode, TiddlyWiki ignores paragraph formatting, and just recognises character formatting, like bold and italic.
It's important to be able to control which type of parsing is performed for different situations.
Prior to 5.0.8-beta, TiddlyWiki parsed the content of an element in inline mode unless the opening tag of the element were immediately followed by a line break. This meant that much of the time element tags would be shunted together into a long line, hindering readability.
The new behaviour for 5.0.8-beta is to parse the content of an element in inline mode unless the opening tag is immediately followed by two line breaks.
To adjust existing content for 5.0.8-beta you will need to manually add the additional line break after the opening tag of elements and widgets whose content should be parsed in block mode.
The positive aspect of the change is that it removes the need to pack multiple HTML tags onto a single line, improving readability.
Examples
Consider the difference between these two examples. First, here's an HTML tag that starts with two line breaks:
<blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
Affichera ceci :
This is a heading
And a paragraph of text.
Code HTML correspondant :
<blockquote><h1 class="">This is a heading</h1><p>And a paragraph of text.</p></blockquote>
Secondly, here's an HTML tag with just a single line break. Notice how the heading is no longer recognised as a heading
<blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
Affichera ceci :
! This is a heading
And a paragraph of text.
Code HTML correspondant :
<p><blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
</p>
The handling of wiki folders has changed. Previously, if the tiddlywiki command was run against a wiki folder that didn't have the necessary tiddlywiki.info file then it would be automatically created. Now, the wiki folder must be initialised with the InitCommand.
This is how to create and start a new server-based wiki:
tiddlywiki mywikifolder --init server
tiddlywiki mywikifolder --server
Note that the name of the clientserver edition has changed to server.
The now macro returns the current date and time in a specified format.
The value doesn't update automatically, like a ticking clock. It updates whenever the macro call is rendered, such as when the containing tiddler's display needs to be refreshed for some other reason.
Parameters
format
A string specifying the desired format, defaulting to 0hh:0mm, DDth MMM YYYY
Note: The format string [UTC]YYYY0MM0DD0hh0mm0ssXXX will return a date string representing the UTC time-stamp as it is used in the TiddlyWiki created and modified time-stamp fields.
Depuis : 5.2.0
You can now pass literal parameters to the now macro in filters. For example, this filter will return all tiddlers created today: [all[tiddlers]] :filter[get[created]format:date[YYYY0MM0DD]match<now YYYY0MM0DD>]
Non-numeric values are treated as having a higher value than any number, and the difference between capital and lowercase letters is ignored. Compare nsortcs.
NW.js est une application OpenSource qui étend les fonctionnalités d'un navigateur web avec celles de Node.js. Il permet l'utilisation d'application web d'une façon similaire aux applications natives, avec tous les accès au système de fichier et autres commodités natives. Allez plus loin sur le site officiel ou avec ce blog d'introduction (eng).
Une introduction à la bible d'Obadiah par Dave Gifford utilisant la macro sommaire et différents réglages personnalisés de TiddlyWiki : un bouton nouveau, ici, modifié ajout d'un viewtemplate personnalisé pour intégrer des notes ou des images dans tout tiddler, et un tiddler transcluant tout contenu, adapté pour faciliter l'impression (ce tiddler).
Open Collective is a platform for transparent fundraising and expenses for projects like TiddlyWiki. It is the official TiddlyWiki community fundraising space.
You can make a fixed one-time donation, or setup a recurring contribution.
The main goals listed for donations are to cover basic costs for community infrastructure like the Discourse forum, and a new goal for supporting the TiddlyWiki Core.
Additionally, the community can make use of the platform for special projects - to pool funds to pay for development, design, or anything else. The File Upload Plugin is the first of these, and we want to welcome others to launch projects here.
L'Open Source est définie par Wikipedia comme une philosophie, ou comme méthodologie éprouvée qui promeut la diffusion gratuite et l'accès libre à la conception et au code détaillé d'un produit fini.
Quand TiddlyWiki génère une liste de tiddlers portant un tag particulier (ex : la liste déroulante d'un tag pilule), it trie les tiddlers selon les règles suivantes :
Commencer par tout tiddler declaré dans le champ list du tiddler, en suivant l'ordre donné.
Pour chaque tiddler T restant, chercher un champ list-before. s'il a le titre du tiddler comme valeur, placer le tiddler T juste avant celle-ci.
Au cas particulier, où le champ existe mais que sa valeur soit vide, placer T au tout début de la liste.
Pour chaque tiddler T restant, chercher un champ list-after field. S'il a le titre du tiddler title comme valeur, placer le tiddler T juste après ce dernier.
Si des tiddlers restent encore, les placer en queue de liste dans l'ordre alphabétique croissant des titres. Les différences entre majuscule et minuscule sont ignorées.
En 1997, un collègue me montra le wiki original de Ward Cunningham. Que quelque chose d'aussi puissant puisse être écrit en seulement 700 lignes de Perl m'impressionna à l'époque, et j'étais aussi fasciné par la manière radicale dont la sécurité et le système de permissions avaient été repensés. Comme beaucoup d'autres développeurs, je me suis jeté sur tous les types de wiki qui me passaient sous la main, afin d'explorer leur utilisation en environnement de travail.
Le principal attrait du wiki pour moi était le sentiment qu'il pouvait remettre en question le paradigme qui prévalait jusqu'alors, à savoir les documents conçus pour être imprimés, et les emails.
Après avoir observé pendant quelques années la manière dont les gens utilisaient les wikis, j'ai remarqué que les utilisateurs avancés faisait grand usage de la possibilité d'ouvrir plusieurs pages de wiki à la fois dans les onglets de leur navigateur, pour se faciliter la comparaison et la révision des pages, la recopie de texte d'une page à l'autre, et pour se constituer une sorte de file de pages en attente d'être lues.
J'ai eu le sentiment que cette capacité à manipuler plusieurs pages en même temps était centrale dans la capacité à réorganiser un wiki, et on considère généralement qu'un wiki réorganisé avec amour a tendance à être plus utile. Pourtant, les interfaces utilisateur des wiki ont toujours été exclusivement conçues pour la présentation et la manipulation d'une seule page à la fois.
Toutes ces réflexions se sont synthétisées lorsque j'ai vu l'interface de Gmail en avril 2004, qui utilisait Ajax de manière ingénieuse pour assembler des mails individuels dans des fils de conversations.
J'ai commencer à expérimenter avec HTML et JavaScript pour pousser l'idée. Je n'avais eu jusqu'à présent pratiquement aucune expérience de l'un ou de l'autre, à part composer quelques pages statiques et des sites ASP simples dans des vies précédentes. Se plonger dans ces techniques orientées client a été une expérience douloureuse ; comme tout le monde, j'étais horrifié de découvrir l'atrocité des incompatibilités et incohériences de la programmation web.
Founded in 2004 by JeremyRuston, Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on Socialtext Unplugged.
In 2007, Osmosoft was acquired by BT and became the champions for open source within the enterprise. As part of BT, Osmosoft has worked on a diverse range of projects within BT and for BT's customers.
Je constituais une équipe chez BT sous le nom Osmosoft. Nous avions comme objectif d'évangéliser les bénéfices de l'open source et d'aider d'autres équipes à réaliser ces bénéfices en pratique. Nous nous sommes aussi rendu compte qu'il était nécessaire d'évangéliser l'usage du Web en général, et les standards web en particullier.
Notre approche était de privilégier la démonstration sur le discours. Nous avons travaillé avec la communauté TiddlyWiki pour étendre l'écosystème, et nous avons construit de nombreux systèmes internes pour BT (certains basés sur TiddlyWiki, d'autres non).
La principale contribution d'Osmosoft à la communauté TiddlyWiki fut la création de TiddlyWeb et TiddlySpace. TiddlyWeb était un serveur robuste, capable de servir des tiddlers sur l'Internet, mais aussi de composer des vues TiddlyWiki à partir de ces tiddlers. Quant à TiddlySpace, il s'agissait d'une tentative pour packager TiddlyWeb de façon plus directement utilisable.
This list contains any usefull resource that have been shared with the TiddlyWiki Community that doesn fit the previous categories. They may be, macros, widgets, code snippts, ideas or more.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists. The original site is missing, but a link to an archive is provided.
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
Une extension pour Mozilla Firefox qui fluidifie l'utilisation de l'enregistreur HTML5 par défaut de TiddlyWiki, et le rend presque aussi convivial que TiddlyFox. L'extension est conçue pour fonctionner immédiatement, sans configuration.
NoteSelf est votre version personnelle, privée, et personnalisable de l'expérience utilisateur d'Evernote.
Vous voulez du cloud ? Bien ! Vous n'en voulez pas ? C'est bien aussi ! C'est à vous, c'est votre choix !
Pourquoi ne seriez-vous pas un peu égoïste ?
NoteSelf est le support parfait pour vos idées, vos notes, vos pensées, vos astuces, vos recettes... tout ce que vous voulez !
NoteSelf les stockera, les indexera et les rendra faciles à rechercher, pour que vous les trouviez instantanément quand vous en avez besoin !
Vous connaissez déjà Evernote et vous l'adorez, nous le savons bien. Il est confortable, il se synchronise, il permet la recherche...
Ouah ! Il est presque parfait, mais que pensez-vous de :
La vie privée : tout est stocké sur les serveurs d'Evernote !
La personnalisation : si vous n'aimez pas l'interface d'Evernote, il n'y a rien à faire.
NoteSelf est construit sur la base de TiddlyWiki, un logiciel libre de wiki personnel puissant, gratuit et hautement personnalisable.
Nous en avons tiré le meilleur, son système puissant de personnalisation, et l'avons combiné avec une des meilleures
bases de données embarquées disponibles, PouchDb, pour y apporter les capacités de synchronisation dont vous avez besoin.
Une extension pour Google Chrome et Mozilla Firefox qui fluidifie l'utilisation de l'enregistreur HTML5 par défaut de TiddlyWiki, et le rend presque aussi convivial que TiddlyFox une fois configurée.
Une extension à la configuration du serveur Node.js de TiddlyWiki qui ajoute la prise en charge des contenus statiques et permet de travailler avec de multiples wikis simultanément.
TiddlyServer prend la commande server de TiddlyWiki sur Node.js, et l'ajoute à un serveur de fichiers statiques. Ça signifie que vous pouvez charger et héberger n'importe quel dossier de donnéesTiddlyWiki de la même façon qu'un TiddlyWiki mono-fichier.
Mais vous n'êtes pas limité à un seul emplacement pour vos fichiers et dossiers partagés, vous pouvez les partager depuis n'importe où sur votre disque (littéralement n'importe quel chemin sur lequel NodeJS peut lancer un stat, un readdir et un readFile). Vous pouvez même les organiser en dossiers virtuels (comme les alias d'Apache et les mounts d'Express).
Évidemment, vous pouvez modifier vos fichiers, pas seulement les consulter ! Les TiddlyWiki mono-fichier utilisent l'enregistreur PUT, qui a besoin d'être patché en utilisant un bookmarlet disponible sur la page d'accueil. Les instructions correspondantes sont disponibles juste sous le titre "One thing that needs to be noted".
Et vous pouvez évidemment modifier vos TiddlyWiki multi-fichiers comme si vous exécutiez node tiddlywiki.js data --server, sauf que vous l'exécutez depuis le chemin où vous l'avez ouvert (p.ex. http://localhost/personal/notes/). Vous pouvez avoir autant de dossier de données ouverts que vous voulez, ils n'entrent pas en conflit entre eux (même si chacun consomme de la mémoire).
Les dossiers de données stockent des tiddlers individuels, pas des wikis entiers. Ils occupent moins de place car ils ne contiennent ni le noyau ni les plugins. La conséquence est qu'ils s'enregistrent beaucoup plus rapidement, surtout à travers internet. Ils s'enregistrent aussi immédiatement (en 10s environ) et enregistrent aussi les brouillons.
NDT
TiddlyWiki mono-fichier
Il s'agit d'un wiki contenu dans un seul fichier HTML, comme le fichier empty.html que vous pouvez télécharger ici. Vous utilisez le wiki en ouvrant le fichier avec un navigateur.
TiddlyWiki multi-fichiers
Lorsqu'un wiki est hébergé sur Node.js, chaque tiddler est stocké dans son propre fichier .tid et ces fichiers sont organisés dans un dossier de données. Pour utiliser le wiki il faut saisir l'URL correspondante dans le navigateur. Plus d'informations ici.
Timimi est une web-extension accompagnée d'un hôte natif qui permet d'enregistrer et sauvegarder vos TiddlyWiki mono-fichier HTML n'importe-où sur votre disque. Une fois installée, vous pouvez enregistrer les fichiers TiddlyWiki sans autre formalité, comme le plugin original Tiddlyfox.
J'utilise TiddlyWiki5 avec Google Firebase depuis plus d'un an. C'est suffisamment stable pour l'utiliser au quotidien. Il y a un accompagnement détaillé sur la façon de créer sa propre instance avec de nombreuses captures d'écran. Le processus complet prend moins de 30 minutes : https://neumark.github.io/tw5-firebase/
Merci de considérer cette version comme une preuve de concept plus qu'un produit fini ! Je me suis concentré sur la collaboration multi-appareils ou en petites équipes :
Authentification de base (les sacs ont une politique d'accès qui détermine qui peut les lire ou les écrire).
De multiples wikis peuvent être hébergés avec le même compte Firebase.
Utilise l'authentification sociale intégrée à Firebase pour identifier les utilisateurs.
Les tiddlers sont verrouillés individuellement en écriture, pour éviter que les utilisateurs écrasent mutuellement leurs modifications.
Fichier exécutable autonome, peut être déplacé, copié, etc.
Le wiki est compressé, il occupe moins d'espace disque (parfois même seulement un tiers de l'espace !)
Convertit n'importe quel fichier Tiddlywiki5 en fichier exécutable twexe, pas besoin de plugin pour TiddlyWiki
Utilise automatiquement l'onglet Sauvegarde du panneau de contrôle, où vous pouvez préciser un dossier pour les sauvegardes si celui par défaut ne vous plaît pas.
Récupérez facilement le fichier HTML du wiki à partir du twexe exécutable si vous en avez besoin
Ouvre la possibilité de lancer des exécutables externes à partir de votre wiki (pour dessiner des graphiques, etc.) - restez à l'écoute !
Reconnaît les images externes (c-à-d avec un champ _canonical_uri)
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
Create concept maps and quickly manifest your ideas in tiddlers.
Create task-dependency graphs to organise and describe your tasks.
Visualise your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualise and describe any network-structure you have in mind.
Note: This is an older version of TiddlyServer. A modern version can be referenced here.
TiddlyServer is a special purpose Desktop app, designed to facilitate managing multiple instances of TiddlyWiki running as a server. It does not require internet acess to access the wikis.
TiddlyServer can import both TiddlyWiki files and TiddlyFolder wikis. For each wiki, you specify a prefix to serve it with and the source to import from. It will copy the wikis to its own internal store and begin serving them up at http://localhost:8080/{prefix}/. The export button for each wiki will convert it to a single file wiki.
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
This new textbook from Soren Bjornstad is highly recommended for learning TiddlyWiki. The presentation and design are also a first class example of using TiddlyWiki.
From the site:
Grok TiddlyWiki is a textbook that helps you build a deep, lasting understanding of and proficiency with TiddlyWiki through a combination of detailed explanations, practical exercises, and spaced-repetition reviews of prompts called takeaways.
One of my favorite aspects of TiddlyWiki has been that it's web-based, making it possible for me to access my wiki from everywhere (especially my phone). That being said, I'm a bit paranoid, so I was left a bit unsatisfied with the tiddlywiki server's HTTP basic auth for protecting my wiki. ~23 commits later, I've created something called twproxy that I'd like to share with you all today, as I'm hoping somebody other than myself will find it useful.
Essentially it is a simple proxy that puts your wiki behind a username, password, and optional 2-factor auth prompt. This gives you added security in addition to the ability to remember your credentials past one browsing session (I was getting sick and tired of typing my username/password in over and over using basic auth).
The CommunitySearch wiki aggregates many public wikis from the community. It is updated automatically every day. At the time of writing, more than 5000 tiddlers are indexed, thus giving access to the largest known collection of TW content.
It lets you search for some specific content among a preselected list of wikis. The indexed content is mostly focused on TW usage, so you would typically use this search system to find information about a particular aspect of TiddlyWiki. Say for example that you want to learn how to make a table of content, type "table of content" in the CommunitySearch box (also accessible in the default tiddler GettingStarted). The search results are links to various wikis, and point directly to the specific tiddlers containing your request.
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
This is my work in progress version of TW5, incorporating various features and ideas as and when they intrigue me. To grab any feature you may wish to try, drag the listed tiddlers across to the dropzone of an empty TiddlyWiki 5.0.10-beta
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10).
Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5.
To share my knowledge, I made a few guides about these 'modifications'.
The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
TWKN will be transferred into TWederation/TiddlyMap format as soon as I am convinced in reliable and secure versioning and multi-user operation in TW format.
Your assistance and support would be highly appreciated.
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
I made this so that some of my friends with absolutely no coding experience could use some of the better features of TW5 without having to learn much. I am hopefully going to continue updating it as I learn new things. There isn't really anything here that isn't available in plenty of other places, but I figured that since I spent a while putting it together and people keep saying that TW needs more documentation I would post it here.
A collection of helpers by Thomas Elmiger, among them a tweet button macro, a text-stretch solution, a snippet extraction macro and a tiddler that installs a scroll-to-top button via drag-and-drop.
Quick Extensions for TiddlyWiki 5 – […] As I take from the community, I am happy if I can give back. You can use my stuff to do whatever you like, but remember to save a back-up first.
This is Mat's, a.k.a <:-) little man-cave in the TiddlyVerse.
Most TW development is, understandably, based on the premise that "Improve code ➔ Better TW". TWaddle is also about developing TW but from the perspective that Bigger community ⇄ Better TW. Thus, TWaddle looks more to people issues - how to attract them, how to make them stick with TW etc.
I'm not a programmer but I am a TW enthusiast so I tiddlefiddle enough to make the occasional discovery of something cool. Given the amount of words I utter, it is also a mere numbers game before I say something that makes sense. TWaddle is intended to capture these eventualities.
Change le répertoire de départ pour la sortie des prochaines commandes. Par défaut, le répertoire de sortie est le sous-répertoire output du répertoire de l'édition courante.
--output <nom de chemin>
Si le chemin spécifié est relatif, il est calculé relativement au répertoire de sortie courant. Par exemple, --output . indique le répertoire courant comme répertoire de sortie.
The pad operator requires at least one parameter which specifies the desired length of the input titles. A second optional parameter can be used to specify the string to pad with (defaults to "0").
[pad[<length>],[<padding-string>]]
length : the desired final length of the input titles.
padding-string: (optional). The string to use to pad to the desired length. Defaults to "0".
Une caractéristique majeure dont plusieurs nouveaux utilisateurs ignorent le degré, est le point jusqu'auquel TiddlyWiki peut être personnalisé, juste par l'ajout, la suppression de tags système au sein de tiddlers shadow bien choisis ou dans vos propres tiddlers personnalisés.
Vous pouvez ajouter et retrancher les fonctionnalités par défaut des tiddlers aussi bien en mode édition que visualisation (au cas où vous trouveriez un sous titre de tiddler distrayant ou que vous souhaitiez avoir un aide-mémoire à visualiser lors de l'édition de tiddler)
Vous pouvez ajouter et retrancher les fonctionnalités par défaut de la mise en page globale (peut-être souhaitez-vous ajouter une horloge au menu latéral, ou remplacer les boutons de contrôle de la page par les vôtres
Vous pouvez aussi revoir l'ordre dans lequel les fonctionnalités sont affichées (comme mettre les tags au dessus des titres des tiddlers, ou le sous-titre de votre TiddlyWiki sous les boutons de contrôles de la page)
Une fois que vous saurez ce que vous faites, tout cela sera vraiment plutôt facile à réaliser.
Ajout de tiddlers sur-mesure dans l'interface utilisateur
Vous pouvez aussi créer tout tiddler de votre choix avec le TagSystème approprié, il apparaitra en son lieu et place. Par exemple, si vous créez un tiddler 'Rappel automatique', ajouter le texte 'C'est un aide-mémoire' et étiquetez le $:/tags/EditTemplate, la phrase 'C'est un aide-mémoire' apparaitra dans chaque tiddler lors de son édition.
Quand vous afficherez de nouveaux tiddlers dans des tiddlers ou dans la mise en page générale, vous aurez probablement à les repositionner de sorte qu'ils apparaissent exactement où vous le souhaitez. Pour ce faire, modifiez le bon tiddler shadow muni du préfixe $:/tags/, et insérez-y le titre de votre tiddler dans le champ list, au bon endroit. Par exemple, si la phrase 'C'est un aide-mémoire', de l'exemple au-dessus, doit s'afficher au-dessus de l'éditeur de tags dans le mode édition, modifiez le tiddler $:/tags/EditTemplate, sélectionnez le champ 'list' field, et insérez [[Rappel automatique]] juste avant $:/core/ui/EditTemplate/tags.
Création de nouveaux boutons pour le MenuOutilVisu et les contrôles de page
Imaginons que vous ayez un tiddler squelette appelé 'Modèle Recette', et que vous souhaitiez un bouton dans le tiddler MenuOutilVisu pour créer des tiddlers 'nouvelle recette' à la demande. Cela nécessite les étapes suivantes :
Pour illustrer votre bouton, si aucune des images du noyau (tiddlers shadow préfixés par $:/core/images/ ) n'est à votre convenance, vous devrez la créer ou en obtenir une au format SVG (par exemple, une de celles de http://flaticon.com), glissez-la dans votre fichier pour la transformer en tiddler, modifiez le tiddler et ajustez sa hauteur et sa largeur à 22px
Passons au tiddler contenant votre tiddler. Créez-le, titrez-le et ajoutez le code du bouton (voir le code ci-dessous par exemple, en l'adaptant à vos besoins si nécessaire) Étiquetez-le par $:/tags/ViewToolbar
Contrôlons la visibilité de votre tiddler dans la barre d'outil par la création d'un tiddler à titrer $:/config/ViewToolbarButtons/Visibility/Recette. Saisissez showdans la zone texte et sauvegardez.
Enfin, positionnons le bouton proprement. Ouvrez le tiddler $:/tags/ViewToolbar et insérez le titre de votre tiddler bouton (cf. titre étape précédente) dans le champ field au bon endroit.
Supprimer les tiddlers shadows de l'interface utilisateur
Dans l'onglet 'Plus' > option 'Shadows' sont listés tous les tiddlers shadows. Dans cette liste se trouvent plusieurs tiddlers préfixés $:/core/ui/. Ce sont les tiddlers du noyau définissant l'interface utilisateur. Ces tiddlers sont étiquetés par des Tags système, supprimer ou ajouter ces tags modifie la présentation de la page et des tiddlers.
Par exemple, $:/core/ui/SideBar/More est le tiddler correspondant à l'onglet 'plus' du menu latéral, étiqueté par le Tag système$:/tags/SideBar de façon à apparaître dans le menu latéral. Supprimer ce tag de ce tiddler supprime le tag du menu, et lui réajouter ce tag le fera y réapparaître.
Vous pouvez suivre le même procédé pour tout tiddler du noyau définissant l'interface utilisateur et donc préfixé par $:/core/ui/. Ainsi encore, supprimer le Tag Système$:/tags/ViewTemplate du tiddler $:/core/ui/ViewTemplate/subtitle fera disparaître les sous-titres de tous les tiddlers.
Modifier un tiddler shadow de cette façon remplacera la valeur par défaut. Pour réinitialiser, il suffit de supprimer le tiddler modifié pour restaurer le tiddler shadow sous-jacent.
The $parameters widget must be used directly in the following situations:
When the default value of a parameter must be computed dynamically
When the $depth attribute is used to retrieve parameters from a parent transclusion (see below)
Content and Attributes
The content of the $parameters widget is the scope within which the values of the parameters can be accessed as ordinary variables.
Attribute
Description
$depth
The index of the parent transclusion from which to obtain the parameters (defaults to 1). See below
$parseMode
Optional name of a variable in which is made available the parse mode of the content of the parent transclusion (the parse mode can be "inline" or "block")
$parseTreeNodes
Optional name of a variable in which is made available the JSON representation of the parse tree nodes contained within the parent transclusion
$slotFillParseTreeNodes
Optional name of a variable in which is made available the JSON representation of the parse tree nodes corresponding to each fill widget contained within the parent transclusion (as an object where the keys are the slot names and the values are the parse tree nodes)
$params
Optional name of a variable in which is made available the JSON representation of the parameters passed to the parent transclusion (as an object where the keys are the parameter names and the values are the coresponding values)
{attributes not starting with $}
Any attributes that do not start with a dollar are used as parameters, with the value specifying the default to be used for missing parameters
{other attributes starting with $}
Other attributes starting with a single dollar sign are reserved for future use
{attributes starting with $$}
Attributes starting with two dollar signs are used as parameters to the transclusion, but with the name changed to use a single dollar sign. The value specifies the default to be used for missing parameters
Note
Note the special treatment required for parameters names that start with a $; this can be avoided by using one of the pragmas
$depth Attribute
By default, the $parameters widget retrieves parameters from the immediate parent transclusion. The $depth attribute permits access to the parameters of parent transclusions by specifying an index to the parent to be inspected ("1" is the immediate parent, "2" is the parent of that parent, etc.). This is useful in some situations where an intervening transclusion prevents immediate access to desired parameters.
$parseMode, $parseTreeNodes, $slotFillParseTreeNodes and $params Attributes
These attributes provide low level access to the contents of the transcluding widget:
The $params attribute provides access to the raw parameters provided to the transcluding widget. Represented in JSON as an object with keys of the parameter names and values of the corresponding parameter values
The $parseMode attribute contains block or inline to indicate whether the contents was parsed in block or inline mode
The $parseTreeNodes attribute provides access to the raw parse tree nodes that represent the contents of the transcluding widget. Represented in JSON as an array of parse tree nodes
The $slotFillParseTreeNodes attribute provides access to the raw parse tree nodes corresponding to the filled slots within the contents of the transcluding widget. Represented in JSON as an object with keys of the slot name and values being an array of parse tree nodes
Examples
Example i: Shows transclusion of Sample Tiddler Template. The template tiddler has two parameters name and age and here their default values are used.
In the simple form the above transclusion is equivalent to
{{Sample Tiddler Template|Jeremy Ruston|45}}
In this simple form, parameters passed by position not by name. So the first value is passed to the first parameter, here name and the second value is passed to the second parameter, here age.
Remarks
Passing parameter by name is good practice and is recommended for clarity. So for parameterized transclusions, the use of $transclude is recommended over simple form transclusion.
When passing parameters value by position, you cannot pass the second parameter while the first one has not been passed.
Example iv: Here the $parameters widget is used to declare a parameter whose default value is transcluded from another tiddler.
\procedure myproc()
<$parameters name={{$:/SiteTitle}} age="21">
My name is <<name>> and my age is <<age>>.
</$parameters>
\end
<$transclude $variable="myproc" age="19"/>
In the simple form the above transclusion is equivalent to
{{Sample Tiddler Template|Jeremy Ruston|45}}
In this simple form, parameters passed by position not by name. So the first value is passed to the first parameter, here name and the second value is passed to the second parameter, here age.
Remarks
Passing parameter by name is good practice and is recommended for clarity. So for parameterized transclusions, the use of $transclude is recommended over simple form transclusion.
When passing parameters value by position, you cannot pass the second parameter while the first one has not been passed.
Example iv: Here the $parameters widget is used to declare a parameter whose default value is transcluded from another tiddler.
\procedure myproc()
<$parameters name={{$:/SiteTitle}} age="21">
My name is <<name>> and my age is <<age>>.
</$parameters>
\end
<$transclude $variable="myproc" age="19"/>
Fournit un mot de passe pour les prochaines opérations de chiffrement.
--password <motdepasse>
Note : Cette commande n'est pas appropriée pour servir un TiddlyWiki protégé par mot de passe. Pour cela, utilisez plutôt l'option password de la commande Server.
The password widget displays a password input box that is bound to a named entry in the TiddlyWiki5PasswordVault. Passwords are currently stored in the browsers local storage and are not themselves encrypted.
TiddlyWiki ships with defaults that are designed to get the best out of modern devices from smartphones to desktop computers. If you need to work on older, less powerful devices, or work with large amounts of content, there are a few steps you can take to improve performance.
Usage
Avoid the "Recent" tab. It is computationally slow to generate and update in response to tiddler changes.
Use the "Vanilla" theme. The default "Snow White" theme includes visual effects like shadows, transparency and blurring that can be slow to render on older devices
Avoid large tiddlers. Large bitmaps can significantly slow TiddlyWiki's performance. For example, an image taken with a modern smartphone will often be 5MB or more. Use ExternalImages whenever possible
Don't have too many tiddlers open at once. Every tiddler you have open will require processing to keep it up to date as the store changes (for example, while you type into a draft tiddler). It is particularly easy when using zoomin story view to end up with dozens of tiddlers listed in the Open tab in the sidebar. Get into the habit of periodically closing all open tiddlers with the close all button
Use the built-in performance instrumentation. Studying the performance instrumentation results can help highlight performance problems
Take advantage of indexed filter operators. The following constructions at the start of a filter run will be optimised to run many times faster than otherwise:
[all[tiddlers]tag[x]...
[all[shadows]tag[x]...
[all[tiddlers+shadows]tag[x]...
[all[shadows+tiddlers]tag[x]...
[all[tiddlers]field:y[x]...
[all[shadows]field:y[x]...
[all[tiddlers+shadows]field:y[x]...
[all[shadows+tiddlers]field:y[x]...
Note that the field indexer currently defaults to indexing field values of less than 128 characters; longer values can still be searched for, but no index will be constructed
Also note that the “field” operator is also used when the operator name is a fieldname, so, for example, [all[shadows+tiddlers]caption[x]... is optimised.
Keep in mind that transcluding separate tiddlers is more performant than heavy use of macros and the difference can be significant in some situations. The result of parsing each tiddler is cached and reused the next time if the tiddler has not changed. The same technique cannot be used for macros and they have to be re-parsed every time, as they are not global but local to the widget tree.
Depuis : 5.1.23 Parse trees are now cached for macros that do not perform any text substitution either via parameters or variables (i.e. $parameter$ or $(variable)$).
Where possible use the SetWidget or VarsWidget with filters instead of the WikifyWidget for declaring variables and string concatenation. The performance of the wikify mechanism is relatively poor as there is no opportunity to cache the parse tree or widget tree.
The core has built-in performance instrumentation for the refresh cycle. See “Performance Instrumentation” on the “Settings” tab of control panel. The wiki will need to be reloaded before it takes effect.
With performance instrumentation switched on, there is additional timing information displayed the browser developer console each time a refresh cycle is triggered. For example:
The information above should be interpreted as follows:
mainRender is the time taken for the initial display of the page template
styleRefresh is the time taken to refresh the page stylesheet
mainRefresh is the time taken to refresh the main page template
As an example, try switching between the sidebar tabs to compare how long they take to render.
More detailed information on filter execution timings is also available. With performance instrumentation enabled, type the following JavaScript command in the browser developer console:
$tw.perf.log()
A table is displayed with the following information:
name - the string "Filter: " plus the text of the filter
invocations - the number of invocations of the filter since startup
totalTime - the total time in milliseconds spent evaluating this filter since startup
percentTime - the percentage of the execution time of this filter against the total execution time of all filters
Remarquez que les doubles crochets ne sont pas requis autour du titre du tiddler cible ; cependant, s'ils sont présents ils seront supprimés automatiquement.
(NDT : Attention en cas de traduction, le lien doit pointer vers le titre original title et pas vers le titre traduit affiché qui ne reflète que le contenu du champ fr-title)
Permaliens vers un déroulé
Le permalien peut aussi spécifier la liste de tiddlers qui seront ouverts dans le déroulé en plus du tiddler cible, à l'aide d'un filtre :
Si le tiddler cible est absent de la liste, il est alors automatiquement inséré au début du déroulé. Ce qui veut dire que les exemples suivants désignent tous les deux le tiddler Tiddlers dans le déroulé Tiddlers, Tags, TiddlerFields :
Il existe des restrictions techniques aux caractères autorisés dans un adressage URL. Afin de permettre à tous les titres de tiddler d'être adressés, les caractères illégaux font l'objet d'un processus appelé « codage URL » où les caractères problématiques sont remplacés par leurs codes numériques. Par exemple, le caractère espace est remplacé par %20.
Aussi bien le tiddler cible que le déroulé filtre devraient être encodés (mais pas le séparateur « : »). TiddlyWiki génère des URLs encodées correctement qui peuvent paraître un peu "moche". Cependant, dans la pratique les navigateurs parviennent heureusement à interpréter parfaitement des caractères arbitraires dans les extraits URL. De ce fait, quand vous créez des permaliens manuellement vous pouvez choisir d'ignorer le codage URL.
Comportement de TiddlyWiki avec les Permaliens
Deux aspects importants du comportement de TiddlyWiki avec les permaliens peuvent être réglés avec les options de l'onglet Réglages avancés du $:/ControlPanel :
d'une part la mise à jour automatique de la zone d'adresse à chaque navigation, et dans ce cas s'il faut inclure la séquence du déroulé aussi bien que le tiddler cible
d'autre part si les mises à jour de la zone d'adresse doivent affecter l'historique du navigateur. Par défaut, c'est non ; mais lorsque oui est sélectionné, vous pouvez reprendre votre navigation entre les tiddlers en utilisant les boutons avancer et reculer du navigateur
Notez que saisir un permalien ou s'y rendre causera toujours le traitement du permalien, ainsi que l'ouverture et la fermeture des tiddlers appropriés en fonction de son contenu.
Détails techniques
Quand TiddlyWiki se lance il traite les permaliens selon les étapes ci-dessous ; ces même étapes sont répétées dynamiquement lors des modifications du permalien (ce qui survient en réaction à l'édition de la barre d'adresse par l'utilisateur, par exemple).
Si le permalien contient un « : », traiter la chaine précédente comme la cible et la chaine qui suit comme le filtre du déroulé
Si « : » est absent, traiter toute la chaine comme la cible et marquer le filtre du déroulé comme non-spécifié
Si le filtre du déroulé est non-spécifié pendant le processus de lancement, alors mettre une chaine vide dans le filtre du déroulé si la cible est spécifiée, ou les tiddlers par défaut si la cible n'est pas spécifiée
Si le filtre du déroulé est non-spécifié hors du processus de lancement, alors affecter le filtre du déroulé au déroulé actuel
Évaluer le filtre du déroulé comme liste du déroulé
Si la cible est spécifiée et absente de la liste du déroulé alors l'ajouter au début
Si la cible est spécifiée alors s'y rendre, autrement naviguer au premier tiddler de la liste du déroulé
J'ai développé un logiciel pour assister dans la saisie et la mémorisation des information de planification des cours et ainsi faciliter/automatiser un ennuyeux travail lors de à la création du document actuel de planification des leçons.
Lorsqu'on enregistre et organise des informations, on se donne pour objectif de pouvoir les réutiliser plus tard. La valeur d'une information conservée est directement proportionnelle à la facilité avec laquelle on peut la réutiliser.
La philosophie des tiddlers consiste à maximiser les possibilités de réutilisation en découpant l'information en unités sémantiques aussi petites que possible, grâce à une modélisation riche des relations entre elles. On utilise ensuite l'agrégation et la composition pour tisser les fragments entre eux afin de construire des déroulés cohérents.
TiddlyWiki a pour ambition de proposer une algèbre pour les tiddlers : une manière concise d'exprimer et d'explorer les relations entre les diverses bribes d'information.
L'une des fonctions principales des blocs de code est de supprimer l'analyse du WikiTexte. Dès que le bloc de code commence l'interpréteur arrête l'analyse du WikiTexte jusqu'à la fin du bloc.
[[img|texte littéral de lien image]] - le texte inclus entre crochets est ignoré, ce qui signifie par exemple que ni les transclusions ni les appels de macros ne peuvent être utilisés pour construire le lien dynamiquement.
[[cible littérale du lien|intitulé littéral du lien]] - le texte inclus entre crochets est ignoré, ce qui signifie par exemple que ni les transclusions ni les appels de macros ne peuvent être utilisés pour construire la cible ou l'intitulé du lien dynamiquement.
<<maMacro ''pas-en-gras'' "texte littéral" "<<expansion-de-macro-ignorée>>" {{transclusion-ignorée}}>> - pour traiter le texte inclus dans un appel de macro, l'interpréteur suit des règles particulières de détection des arguments de macros. Ces règles ne permettent pas d'analyser le WikiTexte, mais après la substitution des arguments dans la définition de la macro, le résultat est analysé à l'aide des règles normales. Le WikiTexte sera donc interprété ultérieurement dans le résultat.
The simplest form of dependency between plugins is that one plugin can declare itself to be a sub-plugin of another plugin by specifying that plugin in the parent-pluginfield. Sub-plugins are displayed in the control panel plugin chooser within the expandable area of their parent plugin. For example, the official plugin library includes the CodeMirror Plugin and also more than a dozen sub-plugins that extend the CodeMirror plugin with optional functionality. Note that sub-plugins cannot themselves have further sub-plugins.
Plugins can also use their dependentsfield to list the titles of any other plugins that should also be installed. Note that the list is not resolved recursively: dependents of dependents will not be installed.
When installing a plugin from the plugin library, both the parent-plugin and dependents fields are used to determine any additional plugins to be installed.
Note that the dependents field is also used by the ThemeMechanism and the LanguageMechanism to switch in dependent theme/language plugins.
These editions contain simple demos of the original set of TiddlyWiki plugins. They were prepared for earlier versions of TiddlyWiki that lacked the plugin library.
Plugin authors are encouraged to provide special information and documentation tiddlers that TiddlyWiki can include as plugin information tabs in the control panel.
Plugins should provide an icon contained in a tiddler with the title formed of <plugin-name>/icon (for example, $:/core/icon).
Plugins expose the names of the individual information tabs that they wish to display in the list field of the plugin tiddler. By convention, some or all of the following should be provided:
readme: basic information about the plugin
license: the license under which the plugin is published
The title of the associated information tiddler must be formed as follows:
$:/<plugin-name>/<current-language>/<tab-name> (for example, $:/core/en-GB/readme)
$:/<plugin-name>/<tab-name> (for example, $:/core/readme)
Thus, plugins can provide language-specific versions of each information tiddler.
Note that information tiddlers should not reference other tiddlers within the plugin. This is because plugins containing themes or languages are dynamically switched in and out as they are selected, and so their information tiddlers may not be available for viewing. The control panel uses the 'subtiddler' attribute of the TranscludeWidget to access these tiddlers, which works independently of the plugin switching mechanism.
Including a plugin as an ordinary tiddler by drag and drop into the browser, will result in the plugin only being active in the browser
It will not be available under Node.js
Option 1:
Using a Node.js configuration option 1 is the most common one
It lowers maintenence, because all plugins can be updated in one go
Option 2:
Option 2 is preferred if you want to work with a fixed configuration
Plugin updates only effect the corresponding wiki
Option 3:
This option allows to add and start an edition without the need to overwrite an existing tiddlywiki.info file
It allows you to start any edition as a client-server edition, even if the tiddlywiki.info file didn't specify it.
Option 4:
Is the exact same mechanism used for a single-file wiki
This mechanism should only be used in a Node.js configuration for testing and debugging purposes, since the plugins are stored in the tiddlers/ directory
Plugins have a plugin-type field that determines how it is treated. The following values are defined by the core:
plugin - an ordinary plugin
theme - a theme plugin (see ThemeMechanism). Only the theme plugin named in the tiddler $:/theme is activated at any one time (along with any dependent theme plugins)
language - a language plugin (see TranslationMechanism). Only the language plugin named in the tiddler $:/language is activated at any one time (along with any dependent language plugins)
The following plugin types are used internally by the core:
import - for the special $:/Import plugin created while importing is in progress
While not supported by the plugin library, it is also possible to use custom plugin types to build plugin-like behaviour with a custom user interface. Plugins with a custom type will automatically receive the same behaviour as plain plugins but can display a custom user interface using an appropriate view template segment.
By default, tiddlers within plugins with custom plugin types will not be registered as shadow tiddlers (the constituent tiddlers can still be addressed as subtiddlers by the TranscludeWidget, ViewWidget or the plugintiddlers Operator). Setting a configuration tiddler $:/config/RegisterPluginType/<plugin-type> to yes will cause the tiddlers within the plugin to be registered as shadow tiddlers.
The plugins can be referenced in tiddlywiki.info by their name (e.g. tiddlytools/magic)
Place the PluginFolders containing the plugins in a plugins folder within the wiki folder. TiddlyWiki will attempt to include every subfolder as a plugin. Do not add the plugin names to tiddlywiki.info. Do not add the PluginFolders under a specific namespace:
On the server, plugins can be stored as ordinary JSON tiddlers but it is often more convenient to store them as separate tiddler files within folders. Plugin folders must contain a plugin.info file that contains the metadata for the plugin. It can also optionally identify files external to the plugin folder that should be loaded as tiddlers.
The plugin.info file should contain the following JSON structure:
The JSON structure for plugin tiddlers is as follows:
By convention, the titles of the individual tiddlers are prefixed with the title of the containing plugin, but they are not restricted to do so.
Note that if the version field is omitted from a plugin.info file when the plugin folder is packed then it is automatically filled in by the core to the current core version number. This is to ensure that all the core plugins carry the correct version number. Generally plugin authors will want to ensure that they do explicitly specify a version number.
Plugins are bundles of tiddlers that are distributed and managed as a single unit. Users can install them with drag and drop, or using the plugin library.
Depuis : 5.1.22 Plugins that contain JavaScript modules require a reload of the wiki before they will work. Plugins that do not contain JavaScript modules are automatically dynamically loaded and unloaded.
Plugins can be used to package any tiddler content, including JavaScriptmodules that extend and enhance the core TiddlyWiki5 functionality. The tiddlers within registered plugins are ShadowTiddlers: they can be freely overwritten by creating a tiddler with the same title, but deleting that tiddler restores the underlying tiddler value from the plugin.
By convention, plugin titles have the form $:/plugins/<publisher>/<name>. Plugins that are part of the core TiddlyWiki distribution have titles of the form $:/plugins/tiddlywiki/<name>.
Plugins have a plugin-type field that determines how it is treated. The following values are defined by the core:
plugin - an ordinary plugin
theme - a theme plugin (see ThemeMechanism). Only the theme plugin named in the tiddler $:/theme is activated at any one time (along with any dependent theme plugins)
language - a language plugin (see TranslationMechanism). Only the language plugin named in the tiddler $:/language is activated at any one time (along with any dependent language plugins)
The following plugin types are used internally by the core:
import - for the special $:/Import plugin created while importing is in progress
While not supported by the plugin library, it is also possible to use custom plugin types to build plugin-like behaviour with a custom user interface. Plugins with a custom type will automatically receive the same behaviour as plain plugins but can display a custom user interface using an appropriate view template segment.
By default, tiddlers within plugins with custom plugin types will not be registered as shadow tiddlers (the constituent tiddlers can still be addressed as subtiddlers by the TranscludeWidget, ViewWidget or the plugintiddlers Operator). Setting a configuration tiddler $:/config/RegisterPluginType/<plugin-type> to yes will cause the tiddlers within the plugin to be registered as shadow tiddlers.
Plugin Dependencies
The simplest form of dependency between plugins is that one plugin can declare itself to be a sub-plugin of another plugin by specifying that plugin in the parent-pluginfield. Sub-plugins are displayed in the control panel plugin chooser within the expandable area of their parent plugin. For example, the official plugin library includes the CodeMirror Plugin and also more than a dozen sub-plugins that extend the CodeMirror plugin with optional functionality. Note that sub-plugins cannot themselves have further sub-plugins.
Plugins can also use their dependentsfield to list the titles of any other plugins that should also be installed. Note that the list is not resolved recursively: dependents of dependents will not be installed.
When installing a plugin from the plugin library, both the parent-plugin and dependents fields are used to determine any additional plugins to be installed.
Note that the dependents field is also used by the ThemeMechanism and the LanguageMechanism to switch in dependent theme/language plugins.
Plugin Ordering
Using the Node.js client-server configuration plugins are activated in the following order:
Including a plugin as an ordinary tiddler by drag and drop into the browser, will result in the plugin only being active in the browser
It will not be available under Node.js
Option 1:
Using a Node.js configuration option 1 is the most common one
It lowers maintenence, because all plugins can be updated in one go
Option 2:
Option 2 is preferred if you want to work with a fixed configuration
Plugin updates only effect the corresponding wiki
Option 3:
This option allows to add and start an edition without the need to overwrite an existing tiddlywiki.info file
It allows you to start any edition as a client-server edition, even if the tiddlywiki.info file didn't specify it.
Option 4:
Is the exact same mechanism used for a single-file wiki
This mechanism should only be used in a Node.js configuration for testing and debugging purposes, since the plugins are stored in the tiddlers/ directory
Plugin Fields
Plugins are stored as tiddlers with the following fields:
Field
Description
author
(optional) Author of plugin
dependents
List of dependencies: plugins that should be installed in order for this one to work
description
Description of plugin
list
Names of exposed plugin information tiddlers (see below)
name
Brief name of the plugin
plugin-priority
(optional) Numerical priority (higher numbers install later, the core plugin has a priority of zero
plugin-type
Generally plugin, language or theme; see PluginMechanism for details
parent-plugin
(optional) Depuis : 5.1.22 Title of the plugin under which this plugin should be displayed as a sub-plugin in the control panel plugin chooser
source
(optional) Source URL of plugin
text
JSON encoding of the list of tiddlers comprising the plugin
title
Title of plugin
type
Must be application/json
version
(optional) Version string (should conform to SemanticVersioning convention)
Un plugin, dans TiddlyWiki5, est un ensemble de tiddlers empaquetés dans un seul tiddler. Les Plugins sont utilisés pour distribuer des composants optionnels et personnalisés de TiddlyWiki.
Les Plugins peuvent contenir des modules JavaScript, des feuilles de styles, et des gabarits pour étendre les fonctionnalités de TiddlyWiki lui-même. Les plugins peuvent aussi être employés pour diffuser du texte oridinaire, des images ou tout autre contenu.
Leurs mise à jour depuis leur source les traite comme une simple unité.
Se reporter au Mécanisme du Plugin pour plus de détail sur la façon dont les plugins sont implémentés en interne.
Installation d'un plugin à partir d'une bibliothèque de plugins
Ouvrez le Panneau de contrôle, cliquez sur l'onglet Plugins, et à nouveau sur un nouvel onglet Plugins
Cliquez sur le bouton Installez un plugin
À l'affichage de la bibliothèque officielle :
Choisir entre plugins, thèmes et langages
Utilisez la recherche et cliquez sur le chevron d'un plugin pour obtenir des détails
Cliquez sur le bouton installez
Une barre d'alerte vous propose de cliquer sur Sauvegarder puis de Rafraichir la page afin que les modifications soient prises en compte par TiddlyWiki
The ThirdFlow plugin brings to you another way to develop customisation plugins for TiddlyWiki 5. It is not enforcing a specific development flow, it simply tries to help you. Otherwise, it tries to stay out of your way.
The FontAwesome plugin supports embedding Font Awesome in TiddlyWiki 5. There is no need to install this font into your operating system in order to use it with TiddlyWiki 5. The font is already embedded in this TiddlyWiki 5 customisation plugin instead, so nothing else to install.
The popup mechanism allows blocks of content to be selectively displayed and positioned with respect to an anchor. It has several parts:
StateTiddlers to record whether a popup is currently displayed or not
The RevealWidget to selectively display the popup content
Depuis : 5.2.4 For positioning the popups relative or absolute coordinates can be used. See Coordinate Systems for more information about usage and format.
For "sticky" popups — those that don't close when clicking inside one — set the class attribute to tc-popup-keep
The ButtonWidget to trigger the display of the popup by setting the state tiddler appropriately
Un pragma est un composant spécial du WikiTexte qui permet de contrôler la façon dont la suite du texte est analysée.
Les pragmas occupent des lignes débutant par un \. Ils ne peuvent être placés qu'au début d'un texte, mais des lignes vides sont autorisées entre eux. Si une ligne de pragma apparaît plus loin dans le corps du texte, il n'est pas pris en compte et apparaît comme du texte ordinaire.
NDT : Depuis : 5.2.0 Les commentaires HTML <!-- texte de commentaire --> sont aussi autorisés avant et entre les pragmas, ce qui facilite la documentation du code WikiTexte.
permet d'ajuster l'ensemble des règles d'analyse du texte
\whitespace trim ou \whitespace notrim
Depuis : 5.1.15 contrôle si les caractères d'espacement sont retirés du début et de la fin de morceaux de texte (la valeur par défaut notrim n'entraîne aucun retrait). Ce paramètre est utile lorsque l'indentation ou les caractères d'espacement générés par les retours à la ligne perturbent la mise en forme du résultat.
\import <expression-de-filtre>
Depuis : 5.1.18 permet d'importer des définitions de macros à partir des tiddlers sélectionnés par une expression de filtre.
The first line of the definition specifies the macro name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the macro.
The lines that follow contain the text of the macro text (i.e. the snippet represented by the macro name), until \end appears on a line by itself:
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Salut, Je suis $name$ et je vis à $address$.
\end
Alternatively, the entire definition can be presented on a single line without an \end marker:
\define sayhi(name:"Bugs Bunny") Hi, I'm $name$.
Macro definitions can be nested by specifying the name of the macro in the \end marker. For example:
Note that the \end marker can optionally specify the name of the function to which it relates, enabling function definitions to be nested inside procedures, macros or widget definitions.
There is also a single line form for shorter functions:
The first line of the definition specifies the function name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the function. The lines that follow contain the text of the function (i.e. the snippet represented by the function name), until \end appears on a line by itself:
The \importpragma is used to import definitions from other tiddlers that are identified with a filter. It is a shortcut syntax for the ImportVariablesWidget.
Depuis : 5.3.0 The \parameterspragma is used within procedure and widget definitions to declare the parameters that are expected, and their default values. It is a shortcut syntax for the ParametersWidget.
To illustrate the use of \parameters pragma, see Core Icons which are parameterised. The first parameter size specified the size at which the icon should be rendered. For example see the text of $:/core/images/print-button tiddler. The first line defines the size parameter as \parameters (size:"22pt")
In the above example, the first line shows a simple transclusion of $:/core/images/print-button icon with size parameter passed by position and is set to 16px. The second line is a transclusion of image with size parameter passed by name and is set to 32px.
The \parsermodepragma adjusts whether the remaining text is parsed in block mode or inline mode. See WikiText Parser Modes for details of parser modes.
As with all pragmas, setting the parser mode this way can only be done at the start of text, not within the main body of the text.
The first line of the definition specifies the procedure name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the procedure. The lines that follow contain the text of the procedure text (i.e. the snippet represented by the procedure name), until \end appears on a line by itself:
The parameters can be declared inside procedures. The parameters widget is necessary in a procedure if you want to use computed default values. For example:
\procedure myproc()
<$parameters name={{$:/SiteTitle}} desc={{$:/SiteSubtitle}}>
This is <<name>> demonstrates <<desc>>.
</$parameters>
\end
<<myproc>>
Affichera ceci :
This is TiddlyWiki demonstrates un carnet de notes web personnel et non linéaire
.
Caution in Using Positional Parameters
Procedures are a shortcut syntax for the SetVariableWidget with an implicit ParametersWidget, so generally there is no reason to have multiple parameters widgets within a definition. In the below example when passing x to myproc, it will also be set to a:
This is because those two parameters widgets are entirely independent. They are both processed as if the other parameter widget is not there.
The positional parameters are only required when using the parameterised transclusion shortcut syntax, and that in other cases it is generally clearer to use named parameters.
To prevent such situation of above example, pass parameters by name as below.
Depuis : 5.1.15 The \whitespacepragma determines how spaces and newlines are treated within wikitext.
notrim – whitespace text is not subject to special processing (the default)
trim – whitespace text is ignored
Note that the processing only applies to the printable text, and not to other text, such as the values of attributes.
The whitespace setting only applies to the parsed content in which it appears. The setting is inherited by embedded Procedure Definitions and Custom Widgets definitions, but is not inherited by Macro definitions.
The first line of the definition specifies the widget name and any parameters. Each parameter has a name and, optionally, a default value that is used if no value is supplied on a particular call to the widget. The lines that follow contain the text of the widget text (i.e. the snippet represented by the widget name), until \end appears on a line by itself:
A pragma is a special component of WikiText that provides control over the way the remaining text is parsed.
Pragmas occupy lines that start with \. They can only appear at the start of the text of a tiddler, but blank lines and comments are allowed between them. If a pragma appears in the main body of the text, it is treated as if it was ordinary text.
Depuis : 5.2.6 Pragmas can have preceding optional whitespace characters.
The precision operator returns a string representation of the input number that has exactly the specified number of significant digits, using whichever is shorter of exponential or fixed notation.
The operator may be used to prepend a number of items to the list.
[list[Days of the Week]prepend[Yesterday Today Tomorrow]]
The operand may list only items without spaces – to include items with spaces, use a reference to an array e.g. prepend the last three short days of the week to the list
[list[Days of the Week]!prepend:3{Days of the Week!!short}]
Ordinairement, le lancement de TiddlyWiki affiche les tiddlers spécifiés par le filtre du tiddler $:/DefaultTiddlers.
Quelquefois il est utile de réouvrir les mêmes tiddlers ouverts au moment de la sauvegarde du fichier. Pour cela, régler $:/DefaultTiddlers à ce filtre :
[list[$:/StoryList]]
Ce filtre renvoie les filtres spécifiés dans le tiddler $:/StoryList, le tiddler système que TiddlyWiki utilise pour mémoriser la suite de tiddlers du déroulé actuel.
Each input title is processed in turn, and its predecessor is located in the list field and appended to the output. If a title is not listed in the field, or is the first item there, then it contributes nothing to the output.
This tiddler describes the different ways in which procedure can be called.
Procedure Call Transclusion Shortcut
To call a procedure, place <<double angle brackets>> around the name and any parameter values.
<<my-procedure param:"This is the parameter value">>
By default, parameters are listed in the same order as in the procedure definition. A parameter can be labelled with its name and a colon to allow them to be listed in a different order.
If no value is specified for a parameter, the default value given for that parameter in the procedure definition is used instead. (If no default value was defined, the parameter is blank).
Each parameter value can be enclosed in 'single quotes', "double quotes", """triple double quotes""" or [[double square brackets]]. Triple double quotes allow a value to contain almost anything. If a value contains no spaces or single or double quotes, it requires no delimiters.
The shortcut syntax expands to the $transclude widget with the $variable attribute specifying the name of the procedure to transclude.
<$transclude $variable="my-procedure" param="This is the parameter value"/>
The widget itself offers greater flexibility than the shortcut syntax, including the ability to specify dynamic parameter values.
Assigning Procedure Calls to Attribute Values
The text of a procedure can be directly assigned to an attribute of a widget or HTML element. The result of the procedure is not wikified, which means that parameter handling does not take place.
<div class=<<myclasses>>>
...
</div>
Using Procedure Calls in Filters
Procedure calls can be used in filters. The text is not wikified which again means that the parameters will be ignored.
This tiddler describes the different ways in which Procedures can be defined.
Procedure Definition Pragma
Procedures are created using the Pragma: \procedure at the start of a tiddler. The definitions are available in the rest of the tiddler that defines them, plus any tiddlers that it transcludes.
\procedure my-procedure(param)
This is the procedure text (param=<<param>>)
\end
Note that the Pragma: \whitespace setting is inherited from the parsing context in which the procedure definition occurs. That means that a tiddler containing multiple procedure definitions only needs a single whitespace pragma at the top of the tiddler, and the setting will be automatically inherited by the procedure definitions without needing the pragma to be repeated.
Procedure Definition with Set Widget
Procedures are implemented as a special kind of variable and so internally are actually defined with a $set widget.
<$set name="my-procedure" value="This is the procedure text">
...
</$set>
Note
that it is not currently possible to specify parameters when defining a procedure with the $set widget.
The tag SystemTag: $:/tags/Global/View is used to define procedures that should only be available within the main view template and the preview panel.
The tag SystemTag: $:/tags/Global/View/Body is used to define procedures that should only be available within the main view template body and the preview panel.
Depuis : 5.3.0 A procedure is a named snippet of text. They are typically defined with the Pragma: \procedure:
\procedure my-procedure(parameter:"Default value")
This is the procedure, and the parameter is <<parameter>>.
\end
The name wrapped in double angled brackets is used a shorthand way of transcluding the snippet. Each of these procedure calls can supply a different set of parameters:
<<my-procedure>>
<<my-procedure "The parameter">>
The parameters that are specified in the procedure call are made available as variables.
How Procedures Work
Procedures are implemented as a special kind of variable. The only thing that distinguishes them from ordinary variables is the way that the parameters are handled.
It returns a unique string that encodes its position within the widget tree, as identified by the stack of transcluded tiddlers that lead to that position.
It is implemented using the transclusion variable.
Parameters
title
The prefix for the returned string, normally a tiddler title
The $qualify widget sets a variable
to a unique string that encodes its position within the widget tree, as identified by the stack of transcluded tiddlers that lead to that position.
Internally, it is implemented using the transclusion variable.
Content and Attributes
The content of the $qualify widget is the scope for the value assigned to the name variable.
Attribute
Description
title
The prefix for the string, normally a tiddler title
name
The name of the variable to be set to the unique string
Examples
The two examples below are identical, but produce different results because the second one has been transcluded from another tiddler.
Each example shows the result of calling qualify and then the value of the transclusion variable.
Une Quine est un programme d'ordinateur qui se programme lui-même.
TiddlyWiki est un exemple inhabituel de quine : c'est lié à la capacité de son noyau à produire une copie de son propre code source pour sauver indépendamment ses propres modifications.
The radio widget displays an HTML <input type="radio"> that reflects whether a given tiddler field has a specified value. Selecting the radio button sets to the tiddler field to the value.
Content and Attributes
The content of the <$radio> widget is displayed within an HTML <label> element also containing the radio button. This means that clicking on the content will have the same effect as clicking on the button itself.
Attribute
Description
tiddler
Title of the tiddler to manipulate (defaults to the current tiddler)
field
The field of the tiddler bound to the radio button
index
Depuis : 5.1.14 The index of the tiddler being DataTiddler bound to the radio button (takes precedence over field)
default
Depuis : 5.2.0 The default value to be used for matching if the tiddler, field or index are missing
value
The value for the field or index of the tiddler
class
The CSS classes assigned to the label around the radio button Depuis : 5.1.14tc-radio is always applied by default, as well as tc-radio-selected when selected
actions
Depuis : 5.1.23 Optional string containing ActionWidgets to be triggered when the value changes. The variable: actionValue is available for the actions
disabled
Depuis : 5.1.23 Optional. Set to "yes" to disable the radio input. Defaults to "no"
Field Mode
This example uses the radio widget to change the modifier field of this tiddler:
<$radio field="modifier" value="JoeBloggs"> Joe Bloggs</$radio>
<$radio field="modifier" value="JaneBloggs"> Jane Bloggs</$radio>
Affichera ceci :
Index Mode
Using the radio widget in index mode requires the index attribute to specify the name of the index of a DataTiddler to which the specified value is assigned.
This example sets the Tree Frog index in the tiddler AnimalColours:
the id field of tiddler: $:/temp/test will be updated
a notification showing the actionValue will be shown
The wikitext of this example is shown below:
\define newText() value: $(actionValue)$
\define radioActions()
<$action-sendmessage $message="tm-notify" $param="RadioWidget ExampleTemplate" value=<<actionValue>> current=<<currentTiddler>> />
<$action-createtiddler $basetitle="$:/temp/test/value" $overwrite="yes" text=<<newText>>/>
<$action-navigate $to="$:/temp/test/value"/>
\end
!! Using Actions
When you select an option below the following acitons will occur:
* the value is written to $:/temp/test/value
* the ''id'' field of tiddler: $:/temp/test will be updated
* a notification showing the ''actionValue'' will be shown
<$tiddler tiddler="$:/temp/test">
<$radio field="id" value="a" actions=<<radioActions>> > Option a </$radio>
<$radio field="id" value="b" actions=<<radioActions>> > Option b </$radio>
<$radio field="id" value="c" actions=<<radioActions>> > Option c </$radio>
</$tiddler>
The wikitext of this example is shown below:
<$codeblock code={{RadioWidget Example!!text}}/>
the id field of tiddler: $:/temp/test will be updated
a notification showing the actionValue will be shown
The wikitext of this example is shown below:
\define newText() value: $(actionValue)$
\define radioActions()
<$action-sendmessage $message="tm-notify" $param="RadioWidget ExampleTemplate" value=<<actionValue>> current=<<currentTiddler>> />
<$action-createtiddler $basetitle="$:/temp/test/value" $overwrite="yes" text=<<newText>>/>
<$action-navigate $to="$:/temp/test/value"/>
\end
!! Using Actions
When you select an option below the following acitons will occur:
* the value is written to $:/temp/test/value
* the ''id'' field of tiddler: $:/temp/test will be updated
* a notification showing the ''actionValue'' will be shown
<$tiddler tiddler="$:/temp/test">
<$radio field="id" value="a" actions=<<radioActions>> > Option a </$radio>
<$radio field="id" value="b" actions=<<radioActions>> > Option b </$radio>
<$radio field="id" value="c" actions=<<radioActions>> > Option c </$radio>
</$tiddler>
The wikitext of this example is shown below:
<$codeblock code={{RadioWidget Example!!text}}/>
Railroad diagrams, sometimes called syntax diagrams, are a visual way of explaining the syntax rules of a computer language. Reading one is like reading a public transport map.
Each diagram starts on the left and ends on the right. Simply follow any line from the startpoint to the endpoint. All the alternative lines are equally valid. A line will sometimes jump over an item that is optional, or loop back to indicate that an item can be repeated.
In the example above, a comma appears between each occurrence of the repeated item. The comma path runs from right to left, and can only be reached by first passing through repeated.
Characters in round boxes are literal, i.e. they denote themselves. A name in a rectangular box denotes a further railroad diagram.
The railroad diagrams in TiddlyWiki's documentation are generated with the Railroad Plugin.
Ce plugin propose le widget <$railroad> pour générer des diagrammes chemin de fer en images SVG.
De plus, le diagramme de notation peut être stocké dans un tiddler dédié avec son champ type réglé sur text/vnd.tiddlywiki.railroad, ce tiddler pourra être ainsi simplement transclu partout où il sera nécessaire.
Le plugin est basé sur une bibliothèque de Tab Atkins qui a été étendue pour la rendre plus malléable, notamment par la possibilité des composant d'un diagramme de fonctionner comme des liens ou d'être transclus à partir d'autres tiddlers.
Le widget railroad utilise une notation spéciale pour construire les composants définis çi-après.
Ici, x et y remplacent tout composant.
Les noms (contrairement aux chaines cotées) ne sont composés que de valeurs débutant par une lettre et contenant seulement lettres, chiffres, soulignements, points et traits d'union.
série
Une série de composants
Les délimiteurs <- et -> permettent d'obliger un composant unique à être traité comme une série. C'est parfois utile pour mettre en valeur un diagramme
optionnel
Un composant qui peut être omis
Les deux points font qu'x soit en tout premier
répété
Une liste d'un ou plusieurs x
Le suffixe + ajoute y comme séparateur entre tout x et le suivant
répétition optionnelle
Une liste optionnelle de x, i.e. une liste de zéro ou plusieurs x
choix
Un ensemble d'alternatives
Les deux points indiquent quelle branche arrive en tout premier. Par défaut, c'est la première branche
chaine / terminal
Un composant littéral ou terminal
Ci-après les règles TiddlyWiki normales pour les chaines cotées
nonterminal
Un composant nonterminal, i.e. le nom d'un autre diagramme
commentaire
Un commentaire
dummy
L'absence de composant
lien
Un lien vers le titre d'un tiddler ou l'URI donné par la chaine ou le nom
transclusion
Interprète le contenu d'un autre tiddler comme un diagramme syntaxique et le transclut dans le diagramme courant
pragma arrow
Contrôle si les chemins répétés ont une flêche ou pas
Peut être réglé sur oui ou non dans un diagramme intermédiaire, si désiré
pragma debug
Provoque l'affichage du diagramme syntaxique d'un diagramme
pragma start/end
Règle le style des diagrammes startpoint ou endpoint
The range operator produces a list of numbers counting up or down. It is useful for counting and numbering.
Depuis : 5.2.0 The range operator has been updated to use multiple operands to specify its parameters. Prior to this version, the range operator only had one operand, with the three parts delimited by ,, ; or :.
The range widget displays an HTML <input type="range"> that reflects a given tiddler field numeric value. Adjusting the range slider sets the tiddler field to the value.
Content and Attributes
The content of the <$range> widget is ignored.
Attribute
Description
tiddler
Title of the tiddler to manipulate (defaults to the current tiddler)
field
The field of the tiddler bound to the range slider
index
Depuis : 5.1.22 The index of the tiddler, a DataTiddler, to which the radio button is bound
min
The minimum value to be able to be set by the <$range> widget
max
The maximum value to be able to be set by the <$range> widget
increment
The minimum amount by which a value may be changed. Defaults to 1
default
If the field is missing or empty this is the default position for the widget handle relative to the min and max values
class
CSS classes to be assigned to the label around the range slider
actions
Depuis : 5.1.23 Optional, A string containing ActionWidgets to be triggered when the value changes. The variable: actionValue is available for all actions. The variable: actionValueHasChanged is always yes here.
actionsStart
Depuis : 5.1.23 Optional, A string containing ActionWidgets to be triggered when the "handle" is clicked. The variable: actionValueHasChanged is always no here
actionsStop
Depuis : 5.1.23 Optional, A string containing ActionWidgets to be triggered when the "handle" is released. The variable: actionValueHasChanged is yes, if the new-value is different to the start-value
disabled
Depuis : 5.1.23 Optional, disables the range input if set to "yes". Defaults to "no"
Bienvenue sur TiddlyWiki, un carnet de notes personnel web et non-linéaire que tout le monde peut utiliser et conserver, sans dépendre d'une quelconque entreprise.
TiddlyWiki est un wiki interactif en JavaScript. Il peut être utilisé dans le navigateur sous forme de fichier HTML autonome ou comme une puissante application Node.js. Il est extrêmement personnalisable : l'interface utilisateur dans son intégralité est elle-même implémentée en WikiText recomposable à volonté.
Ouvrez un terminal de ligne de commande et saisissez :
npm install -g tiddlywiki
En cas d'erreur, il faudra peut-être relancer la commande en tant qu'administrateur :
sudo npm install -g tiddlywiki (Mac/Linux)
Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version
En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple 5.3.2-prerelease ; d'autres informations de débogage peuvent aussi apparaître).
Faites l'essai :
tiddlywiki monnouveauwiki --init server pour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveur
tiddlywiki monnouveauwiki --listen pour démarrer TiddlyWiki
Cliquez sur le bouton Enregistrer les modifications de la barre latérale, OU
tiddlywiki monnouveauwiki --build index
L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki sera disponible seulement dans le répertoire où vous l'avez installé.
Si vous utilisez Debian ou une distribution Linux dérivée de Debian et que vous recevez une erreur node: command not found alors que le paquet node.js est installé, vous devrez peut-être créer un lien symbolique entre nodejs et node. Consultez le manuel de votre distribution et de whereis pour créer un lien correctement. Voir le rapport d'erreur 1434 sur github.
Exemple pour Debian 8.0 : sudo ln -s /usr/bin/nodejs /usr/bin/node
Vous pouvez aussi installer d'anciennes versions de TiddlyWiki ainsi :
L'exécution du programme tiddlywiki depuis la ligne de commande démarre le noyau TiddlyWiki, charge les plugins de base et met en place une structure de wiki vide. Puis les arguments de la ligne de commande sont traités à la suite, de gauche à droite. Les arguments sont séparés par des espaces.
Le premier argument est un chemin optionnel vers le dossier à charger. Si absent, le répertoire courant est utilisé.
Suivent les commandes proprement dites, avec leurs arguments spécifiques, chaque commande étant annoncée par le préfixe --.
Si vous avez installé TiddlyWiki sur Node.js de manière standard, vous pouvez le mettre à jour dès qu'une nouvelle version est publiée, à l'aide de la commande suivante :
The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.
All the scripts expect to be run from the root folder of the repository.
This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.
To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.
Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).
test: build and run tests
This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.
lazy: serves tw5.com with lazily loaded images
./bin/lazy.sh <username> [<password>]
Or:
./bin/lazy.cmd <username> [<password>]
This script serves the tw5.com-server edition content with LazyLoading applied to images.
replaces all filter output so far with a single item by repeatedly applying a filter run to each input title
input
all titles from previous filter runs
output
the accumulated single item
Each input title from previous runs is passed to this run in turn. The result of each previous call to this run is made available in the next call via the variable named "accumulator". The result of the last call to this run is returned as the output. A typical use is to add up the values in a given field of each input title.
The following variables are available within the filter run:
accumulator - the result of the previous filter run
currentTiddler - the input title
..currentTiddler - the value of the variable currentTiddler outside the filter run. Depuis : 5.2.0
index - the numeric index of the current list item (with zero being the first item in the list)
revIndex - the reverse numeric index of the current list item (with zero being the last item in the list)
length - the total length of the input list
Compare named filter run prefix :reduce with reduce Operator which is used to flatten a list of items down to a single item by repeatedly applying a subfilter.
Unlike the reduce Operator, the :reduce prefix cannot specify an initial value for the accumulator, so its initial value will always be empty (which is treated as 0 by mathematical operators). So =1 =2 =3 :reduce[multiply<accumulator>] will produce 0, not 6. If you need to specify an initial accumulator value, use the reduce Operator.
=1 =2 =3 :reduce[multiply<accumulator>]
→ Empty initial value is treated as 0 by mathematical operators
=1 =2 =3 +[reduce<multiply-input>,[1]]
→ Setting initial value is sometimes necessary for correct results
Depuis : 5.1.23 The reduce operator runs a subfilter for each input title, passing the result of the previous subfilter run as a variable. The initial value of the accumulator can optionally be specified. It returns the result of the final subfilter run.
The reduce operator is used to flatten a list of items down to a single item by repeatedly applying a formula. A typical use is to add up the values in a given field of a list of tiddlers.
The following variables are available within the subfilter:
accumulator - the result of the previous subfilter run
currentTiddler - the input title
..currentTiddler - the value of the variable currentTiddler outside the subfilter. Depuis : 5.2.0
index - the numeric index of the current list item (with zero being the first item in the list)
revIndex - the reverse numeric index of the current list item (with zero being the last item in the list)
length - the total length of the input list
If the reduce operator receives no input, its output will be empty. The else Operator can be useful in such cases.
Literal filter operands cannot contain square brackets but you can work around the issue by using a variable:
If the optional second parameter is not given, the initial accumulator value will be empty. Numerical operators treat empty input as if it was the number 0. See the multiply-input examples for how this can affect the result of reduce in some cases.
Les Tiddlers référents proposent une information sobre d'une façon compréhensible et interconnectée. Le lecteur peut être, aussi bien, un utilisateur moyen ou un expert.
Il existe plusieurs subdivisions :
Concepts
Définitions, dont l'ensemble forme un glossaire
Manuel utilisateur
Présente les détails techniques des fonctionnalités WikiTexte
Subdivisions : messages, opérateurs, widgets, etc
Manuel dévelopeur
Présente les détails techniques de l'architecture interne de TiddlyWiki
Le matériel de référence est rédigé à la troisième personne, un style formel qui évite de s'adresser au lecteur, pour se focaliser sur la façon dont se comporte TiddlyWiki lui-même. La voix passive est souvent appropriée :
"Le gabarit spécifié via un tiddler" plutôt que "spécifiez le gabarit via un tiddler"
"Le widget peut être employé à divers usages" plutôt que "vous pouvez employer le the widget à divers usages"
Mais "Ce widget offre plusieurs utilisation possibles" est meilleur, car moins alambiqué et plus succinct
Les double négations, les négations contractées et les expressions pouvant conduire à ignorer une négation ou à faire un contresens accidentel par omission doivent être évitées dans les tiddlers référents.
Refnotes plugin is a set of macros and stylesheets for creating abbreviations, footnotes and citations. It also makes tables of footnotes, abbreviations (glossary) and references (bibliography table).
The refresh mechanism is the part of the WikificationMechanism concerned with updating a rendering when there are changes in the tiddler store.
The refresh mechanism is notified of changes to the tiddler store asynchronously. This is done so that multiple consecutive changes can be coalesced into a single change notification. Thus, a series of action widgets modifying several different tiddlers will only trigger a single refresh cycle.
When changes occur, the rendering is updated by calling the "refresh" method of the root widget. The refresh method determines whether the widget needs to be updated to reflect the incoming changes, and then recursively calls into the refresh methods of each child widget
The refresh cycle is inherently fairly slow because it involves visiting every node in the render tree. To maintain performance there is a RefreshThrottling mechanism that enables refresh processing to be deferred when rapid changes occur to the same tiddler.
The RefreshMechanism allows the refresh cycle to be throttled (or deferred) when rapid changes occur to the same tiddler. It is used to maintain responsiveness while editing a draft tiddler, but can also be used on other tiddlers.
The rules governing refresh throttling are:
When a change notification occurs, throttling will only take place if all of the modified tiddlers meet at least one of these criteria:
Has the field draft.of
Has the field throttle.refresh
Has a title prefixed with $:/temp/volatile/
If the refresh cycle is to be throttled, a timer is set for the internal specified in $:/config/Drafts/TypingTimeout (cancelling any preciously set timer)
When the timer fires, the refresh cycle is triggered, passing the aggregated titles of all the deferred refresh cycles
Regular expressions are concise strings of characters that denote patterns of text to search for. The format used in TiddlyWiki is fully defined in this Mozilla reference.
The filter syntax makes it impossible to directly specify a regular expression that contains square brackets. The solution is to store the expression in a variable. See the examples.
The parameter X can optionally start or end with a string of flags:
Only the i flag is generally useful: it forces the different between capital and lowercase letters to be ignored.
If X is empty, regexp will match all of the input tiddlers.
→ non-system tiddlers with Wiki in their title, ignoring case
[!is[system]regexp[Wiki(?i)]]
→ same again
[regexp[(?i)\.jpe?g$]]
→ tiddlers with titles ending in .jpg or .jpeg, ignoring case
[regexp:created[^201408]]
→ tiddlers created in August 2014
The regular expression [0-9]{2} matches two consecutive digits. Because it contains square brackets, the way to use it with the regexp operator is via a variable, as follows:
This release is the culmination of a large scale refactoring of the widget mechanism of TiddlyWiki5. There are several changes to be aware of if upgrading from earlier versions:
The following widgets have been removed:
<$setstyle> - use <div style=<<macroName Param>>> instead
<$video> - will return in a later release
<$datauri> - use the <<makedatauri>> built-in macro instead
ListWidget - the list widget itself no longer generates HTML nodes, so you'll often need to wrap the template in a <div> or a <span> to be able to style the content
Added a dropdown to the edit template for setting the tiddler type
A saver module for Microsoft Internet Explorer version 10 and above. Clicking save in the sidebar causes the browser to pull up a bar at the bottom of the window where you can click save. You then get a new copy of your wiki in the downloads folder.
Support for new tw-close-other-tiddlers message (eg, )
For http://five.tiddlywiki.com, add a tiddler info tab with a link to the static representation of the tiddler
Improved generation of qualified tiddler titles for state storage
Instead of $:/state/tab/sidebar-{$:/core/ui/SideBar|$:/core/ui/SideBar||}{$:/core/ui/PageTemplate|$:/core/ui/PageTemplate||} one gets $:/state/tab/sidebar-{1743827719}
Significant updates to the structure and content of the user documentation
Added a new plugin for displaying corner ribbons; currently used for a version banner on tw5.com
Split Snow White theme into a base Vanilla theme with all the basic formatting, leaving the decorative bits to Snow White
Existing TiddlyWikiFolders will need updating to include Vanilla as an additional theme
The page building blocks are now driven by the system tag $:/tags/PageTemplate
Changes to the importing process to enable a smoother Upgrading process
Ignores attempts to import plugins that are older than currently installed plugins
System tiddlers are now imported as usual
If $:/theme isn't defined or refers to a missing tiddler, then fallback through Snow White to Vanilla. This means that empty.html now defaults to Snow White
Added support for saving changes on Windows network drives
Refactored configuration processing so that ordinary tiddlers are processed after shadow tiddlers. This resolves an issue whereby user stylesheets were being overridden by shadow stylesheets
Fixed issue with offline snapshot of server edition erroneously including shadow tiddlers
Fixed problem with corrupted upgrades from 5.0.x-prerelease to 5.0.x-beta
The default output location for command line operations has changed to the /output folder within TiddlyWikiFolders (it used to be current directory)
Note that the shadow tiddler $:/core/ui/PageMacros has changed with this release. If you've made modifications to it you should copy your modifications to a new tiddler, delete $:/core/ui/PageMacros, perform the upgrade and then manually update the new copy of $:/core/ui/PageMacros
Many performance optimisations, particularly for filter operations
Added support for PermaLinks and browser back and forward buttons
Added support for WikiLinks in Markdown via [link text](#TiddlerTitle)
Added support for explicit external Linking in WikiText (eg [ext[tooltip|url]])
Replaced hamburger menu icon with double chevron icon
Enhance plain text parsing to use the CodeBlockWidget, and hence use syntax highlighting if the plugin is installed. This gives us syntax highlighting for JavaScript shadow tiddlers, amongst other things
Improvements to the German, French, Italian, Japanese and Chinese translations
This release includes a number of features designed to improve the experience of TiddlyWiki with a screen reader. Particular thanks to @domasofan for his feedback
Added label and title for show/hide sidebar buttons
The Plugins tab of the control panel has been improved with the addition of documentation tabs that plugins can use to show documentation. There is also a larger draggable area for dragging tiddlers across to other wikis.
Configurable Button Toolbars
The page toolbar and the tiddler toolbars can now be configured with several new buttons - see the control panel under the Appearance and Toolbars tabs.
The sidebar tools tab now shows all the available page controls, allowing them to be invoked or checked to appear in the toolbar. The tiddler info area now includes a tools tab that includes buttons for all the tiddler actions.
Presents incoming tiddlers as a pending import list that allows the user to inspect them and, if necessary, explicitly deselect them from the actual import
Provides UpgraderModules with an opportunity to process each incoming tiddler
The plugin upgrader module handles version checking of plugins and upgrading them from a special UpgradeLibrary plugin tiddler
TiddlyWiki now takes a much more conservative approach to recognising CamelCase terms that should be automatically linked. Previously, the dash and underscore were treated as lower case letters, leading to a number of false positives. See the GitHub bug #337 for details.
Automatic Permalinking Off by Default
With previous beta releases of TiddlyWiki the browser address bar is automatically updated so that it dynamically reflects the tiddlers that are currently open. This makes it easier to get a permalink for copying and pasting elsewhere, but it leads to much confusion for casual users who don't always understand why unexpected tiddlers are being displayed after they have refreshed the page in the browser.
For 5.0.14-beta, the setting has been changed. Visit control panelAdvanced/Settings to switch the setting back to "Include the target tiddler and the current story sequence".
5.0.16-beta brings more incompatible changes than any previous release. These changes are likely to break almost all plugins written for previous releases of TiddlyWiki 5, and will break many customisations.
Changed all CSS class prefixes from tw- to tc- (eg tw-tiddler-frame has become tc-tiddler-frame; missing prefixes have also been added, so btn-invisible has become tc-btn-invisible)
Changed all message prefixes from tw- to tm- (eg tw-close-tiddler has become tm-close-tiddler)
Changed all variable prefixes from tw- to tv- (eg tw-config-toolbar-icons has become tv-config-toolbar-icons)
Changed prefix/removeprefix filter operators to be case-sensitive
Extend the all operator to be able to select all the source tiddlers
Fixed problem with single line macro definitions incorrectly including whitespace in the value. (For example, \define mymacro() yes would set the macro value to " yes", with a leading space)
This release includes major improvements from @giffmex to the welcome and tutorial documentation, and new development docs incorporating the work of @cheigele and @cjrk.
Incompatible Changes
Change System Tag $:/tags/stylesheet with $:/tags/Stylesheet
The issue is that the capitalisation of $:/tags/stylesheet is not consistent with other system tags. This release adds support for $:/tags/Stylesheet, and adds a deprecation warning if $:/tags/stylesheet is used. Support for $:/tags/stylesheet will be removed before the beta.
Added support for $:/tags/Stylesheet and a deprecation warning when $:/tags/stylesheet is used
The use of the title attribute in the ButtonWidget was not consistent with the tooltip attribute used by the ImageWidget and LinkWidget. This release adds support for the tooltip attribute to the ButtonWidget alongside the existing support for the title attribute, but with a deprecation warning.
As discussed in the associated ticket, the support for regular expression filter operands is incomplete and inconsistent. The plan is to remove support for this feature in the next release. A new filter operator has been provided to replace it, along with the addition of a deprecation warning that is displayed whenever regular expression filter operators are used.
This is a minor release prior to the full release of TiddlyWiki on September 20th. The documentation has been cleaned up and improved (with more improvements to come).
File Layout of tiddlywiki.com
The layout of files on tiddlywiki.com has been adjusted to make it more logical. See the ticket for a discussion. You can see the source files that make up tiddlywiki.com at https://github.com/Jermolene/jermolene.github.com
Hackability Improvements
Added first iteration of a list-links macro (further improvements are planned)
Added support for importing .markdown and .md files
There is a new setting in the control panel to enable performance instrumentation, making it much easier to measure and improve performance issues.
New Editions
Three new editions of TiddlyWiki are included in this release. These can be used as starting points for creating your own wiki for several purposes:
The Résumé Builder Edition by @inmysocks is a custom edition to guide you through the process of using TiddlyWiki to create a good looking résumé (or curriculum vitæ)
The Blog Edition provides tools for using TiddlyWiki under Node.js to create a static HTML blog that can be published on GitHub pages (or similar)
The Text-Slicer Edition is a custom edition with tools to help advanced users slice longer texts up into individual tiddlers.
External Text Tiddlers
Limited support for tiddlers stored in external .tid files:
standalone TiddlyWiki HTML files with external text tiddlers can be built under Node.js
wikis with external text tiddlers can be worked with in the browser, automatically lazily loading the content of external text tiddlers when it is first referenced
saving changes in the browser doesn't work as expected: if edited, the external text tiddler is replaced with an ordinary tiddler
lazy loading of external text tiddlers doesn't work in Chrome when viewing the TiddlyWiki HTML file on a file: URI; it works OK in Firefox
lazy loading works on an HTTP URI on all browsers as long as the target file is either stored on the same domain or is served by a server that supports CORS
See Alice in Wonderland for an example. Try opening it without a network connection.
New "Tight" Theme
A new theme called "Tight" uses reduced padding, margins and font-sizes to pack as much text as possible:
Other Improvements
Translation Improvements
Added Swedish translation by @Superdos
Added Korean (Korean Republic) translation by @araname
Enhanced the tiddler editor to accept new fields and tags when clicking confirm, without having to click "Add tag" or "Add field"
Added new fold and fold others buttons to the tiddler toolbar to temporarily hide the body of a tiddler, and also added new fold all and unfold all page buttons
Added ability to disable individual WikiText parser rules (see the Advanced tab of $:/ControlPanel). Also added a simple setting for disabling automatic linking of CamelCase words
Extended support for automatically linked system tiddler titles to include digits and underscore
Added warning when trying to use plugins designed for TiddlyWiki Classic
Upgraded to version v8.8.0 of highlight.js for the Highlight Plugin
Removed the need to manually confirm deleting alerts
Added new utility method $tw.utils.tagToCssSelector(tagName) for converting tag titles into a form suitable for matching the tc-tagged-*classes generated by TiddlyWiki
Fixed problem with tiddler titles such as $:/templates/something being erroneously classed as $:/temp tiddlers, and so excluded from syncing
Switched to absolute date format in tiddler subtitles
Node.js Improvements
Fixed problem with the filesystem adaptor saving new image files as base64-encoded .tid files instead of as native binary files with an accompanying .meta file
Extendedtiddlywiki.files support in TiddlyWikiFolders to allow directories to be loaded recursively, as well as individual files
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Added support for extensible formatting toolbars for the editor widgets.
Formatting operations for WikiText, with support for Markdown:
Character formatting operations for bold, italic, strikethrough, underline, superscript, subscript, inline monospace
Line formatting operations for monospaced blocks, quoting, headings and both numbered and bulleted lists
Insert picture from a dropdown chooser
Stamp snippet of pre-programmed text
Excise selected text into a new tiddler
Optional automatic resizing to fit content
Full keyboard shortcut editor in control panel. Shortcuts are also shown in the toolbar button tooltips
Improved Bitmap Editor
The bitmap editor has been enhanced with a toolbar supporting:
Painting with selectable colour, width and opacity
Clearing the image
Resizing the image
Keeping track of recently chosen colours
Improved Plugins
Several of the official plugins available in the plugin library have been updated for this release. Upgrading will automatically update any installed plugins.
The CodeMirror plugin has been updated to version 5.13.2, and integrated with the new editor toolbars. The default configuration has been updated to include syntax highlighting for HTML, JavaScript, CSS, XML, TiddlyWiki Classic and Markdown.
The Markdown plugin includes formatting toolbar buttons and a new "new markdown tiddler" button in the Tools tab of the sidebar.
The experimental Evernote plugin allows notes and images from .enex files to be imported into TiddlyWiki.
The new Internals plugin provides features to help understand the internal operation of TiddlyWiki, including new preview modes in the editor showing both the parse and widget trees of the current tiddler
Ability to rearrange the "Open" sidebar panel and the tag dropdown (and new tiddlers can be opened by dragging them to the list)
Ability to reorder entries in tag dropdowns
Dragging a tag pill is now equivalent to dragging all of the tagged tiddlers together
Entries in the control panel "Appearance"/"Toolbars" tab can be reordered by drag and drop
The image shown while dragging now reflects the dragged item, instead of being a generic drag pill
New "Heavier" Theme
A new theme called "Heavier" thickens TiddlyWiki's default lightweight fonts. A variant "Tight-Heavier" combines the "Heavier" theme with the existing "Tight" theme:
Refactored the display of plugin tiddlers to use the same format as the control panel, adding the shadow tiddler listing as an overridable extension tab
Added a new tab in the “More” sidebar providing quick access to all installed plugins
Fixed height of preview pane to use a scrollbar when fixed height layout is selected
Extended editor "link" button to create external links and missing links
Another improvement that benefits users of translations is the addition of about 800 new transliteration pairs. These are substitutions that are performed when converting a tiddler title into a filename, such as the two characters "oe" for the single character "œ". See the commit for more details. The result is that automatically generated filenames are much more readable.
Usability Improvements
Added new "Explorer" tab to "More" sidebar and underlying tree Macro
After encountering significant problems we've reluctantly decided to remove support for multiple sub-operators with the is Operator that was added in v5.1.16.
Usability Improvements
Improved appearance of TiddlyWiki's "red screen of embarrassment"
Bug Fixes
Fixed problem with extraneous space in new journal titles
Fixed problem with repeated use of "new journal" with text set
In previous versions of TiddlyWiki, there were some special character sequences in tiddler titles that would break certain features. For example, a tiddler title ending in double quotes would cause the Table-of-Contents Macros to render incorrectly.
As of 5.1.18, many of these problems have been fixed by refactoring the features to use the latest abilities of wikitext:
Note that using certain characters in tiddler titles will still prevent some features from being used correctly. For example, two vertical bar characters are used in the double curly braces transclusion syntax to separate the tiddler title from the template title: {{title||template}}. However, although it would be impossible to transclude a tiddler called title||template using that syntax, one could still transclude it using <$transclude tiddler="title||template"/>.
Extended permalink/permaview to copy the URL to the clipboard as well as updating the address bar. This behaviour can be customised in $:/ControlPanel settings
Added new stateTitle, stateField and stateIndex attributes to the ButtonWidget and the RevealWidget, making it possible to use state tiddlers whose titles contain !! or ##
Enhanced the search Operator to support searching arbitrary lists of fields, literal searches, whitespace-tolerant searches and regexp searches
Added support for a navigation scroll offset to avoid navigating to tiddlers resulting in them being obscured under a position:fixed top menu bar – see Hidden Setting: Scroll Top Adjustment
Une nouvelle version mineure avec des mises à jour de la documentation, quelques corrections de bugs, et quelques améliorations.
Améliorations d'usage
Amélioration de la gestion des erreurs liées au plugin KaTeX pour les cas où le contenu LaTeX est malformé ou non reconnu.
Améliorations pour les bricoleurs
Amélioration du style du séparateur avant l'article sans étiquette dans la liste des tags de la barre latérale
Amélioration de la gestion d'erreur lors pour l'enregistreur de type dépôt (qui est utilisé pour enregistrer vers TiddlySpot)
Amélioration de la détection d'erreurs dans la vue sur le déroulé
Correction d'erreurs
Correction des crashs causé par des plugins mal formatés
Correction d'un problème faisant que les informations sur un tiddler n'étaient pas supprimées par le plugin de synchronisation après la suppression d'un tiddler
Correction de la gestion HTTP pour considérer le code de réponse 201 comme un succès.
Contributeurs
@Jermolene aimerait remercier les contributeurs de cette version, qui ont généreusement donné de leur temps pour aider à améliorer TiddlyWiki :
There is now finer control over TiddlyWiki's default behaviour of removing duplicates from filter results, making it much easier to work with the new mathematics and string operators:
Added support for new = prefix for merging filter runs without removing duplicates
Added pluggable index modules to accelerate the field Operator and the tag Operator (in tests on a wiki with 60K tiddlers, startup time is reduced by 25% with these optimisations, and refresh time is reduced by a factor of three.)
Optimised the "Classic" storyview to perform much faster when the animation duration is set to zero (approximtely 50% speed improvement was observed in tests opening a storyview with 8,000 entries)
Optimised the RevealWidget to avoid using the relatively slow localeCompare() method to compare strings
Added support for searches anchored to the start of a field
Bug Fixes
Fixed a long standing problem with the main standalone HTML file template whereby raw markup tiddlers would be included even if not selected by the save filter
Fixed overlapping dropdowns with sticky titles enabled
Removed apparently obsolete limitation of selection wrapping in text editor
Fixed problem using the TiddlySpot saver with cookies disabled
Fixed framed text editor to use correct background colour
Fixed problem with the class tc-sidebar-lists being used on two different areas of the sidebar, making it impossible to distinguish them in CSS selectors
Fixed problem with unnecessary "list" field created when renaming tiddlers
Congratulations to Thomas Elmiger for his winning design for the banner for this release (here are the other entries).
Major Improvements
Dynamic Plugin Loading
Plugins can now be loaded or deleted dynamically, without requiring a reload – as long as they don't contain any JavaScript modules. Plugins that require a reload are indicated in the plugin chooser in $:/ControlPanel.
A new "Updates" tab listing all upgrades available from a plugin library, and a button to update all of them with one click
Tabs are now used to display plugin libraries within the plugin chooser
The plugin chooser now displays plugins that provide add-on functionality to another plugin as nested "sub-plugins", making the main listing easier to navigate
Plugins may now declare dependencies that are automatically installed without user intervention
All plugins are now displayed more consistently, including a concise, informal name (in addition to the description and title)
Client-Server Improvements
This release sees several improvements to the client-server configuration:
Improved resilience to connection errors. Errors encountered by the browser are automatically retried, and when they succeed the associated error messages are automatically removed
Changes to system tiddlers are now synchronised from the server to the browser
Deletions of tiddlers on the server are now synchronised to the browser
New "cloud" page control button with a dropdown menu showing status and additional actions:
"Refresh from server" to force an immediate check for changes from the server
"Logout"
"Save snapshot for offline use" to save a copy of the wiki without the client-server components
"Copy syncer logs to clipboard" to make it easier to ask end users for debugging information
Added "filter" and "exclude" parameters to the GET /recipes/default/tiddlers.json endpoint to allow the returned tiddlers and fields to be filtered
Enhanced LazyLoading to include skinny versions of tiddlers in the HTML file, and to avoid unnecessary loads from the server
The official plugin library is now disabled when the tiddlyweb adaptor is active
mis à jour "Gruvbox" palette readability of toolbar buttons
Keyboard Handling Improvements
ajouté support for navigating the search and new tag dropdowns via the keyboard. The keyboard-driven-input Macro can be used to add this capability to other dropdowns
ajouté a tabIndex property to the tiddler editor input area to make it easier to use the tab key to move between edit controls
étenduButtonWidget and DroppableWidget so that changing the class attribute does not trigger a refresh. This makes it easier to use classes to trigger CSS animations
étendu the RevealWidget to optionally dynamically refresh popup positions when the state tiddler changes
étendu the WidgetMessage: tm-scroll message to allow the target element to be specified by a CSS selector, making it possible to scroll to positions within a tiddler
étendu the password prompt to enable it to be customised
étendu syncer to enable syncadaptors to customise the login prompt
étendu the tabs Macro to support actions and explicitState attributes
mis à jour (and ici) filters used for syncing on node.js and saving the single file version to exclude multiple story lists and history lists based on their prefix, as well as multiple tiddlers that might be used for the import process
ajouté buttons to the Edit Template toolbar for the editor-height and the stamp tool for tiddlers of type application/javascript,application/json and application/x-tiddler-dictionary
mis à jour all instance of the tabs Macro in the core to use the explicitState attribute
ajouté support for the meta key as a modifier in actions
ajouté the new Consent Banner Plugin plugin helps make websites that are compliant with "cookie legislation" such as the EU General Data Protection Regulation.
It presents a banner inviting the user to accept or reject cookies, keeping track of their consent in local storage so that the banner can be hidden on subsequent visits.
By default, content embedded with <iframe>, <embed> and <object> is blocked unless the user consents to accept cookies.
Consent status is available via a configuration tiddler so that it is possible to construct content that behaves differently depending upon whether consent has been granted. As an example, a macro is provided for embedding YouTube videos that automatically uses the youtube-nocookie.com variant of video URLs unless the user has accepted cookies.
Please note that using this plugin does not guarantee compliance with any particular legislation. You will need to understand the technical issues specific to your situation, and if necessary seek legal advice.
Freelinks Plugin
ajouté (and ici) support for ignoring case when matching titles
corrigé bug with autolinking within HTML <a> elements
corrigé "409 conflict" errors with the GitHub saver when saving within 60 seconds of the last save
corrigé behaviour of system tiddler syncing with the client server configuration. By default, changes to system tiddlers are not synced from the server to the client, restoring the behaviour from v5.1.21 and earlier. Bidirectional syncing of system tiddlers can be enabled with the configuration tiddler $:/config/SyncSystemTiddlersFromServer
Changed dragging behaviour so that you can drag a tiddler title into an edit box to insert the title, making link creation easier. (This change doesn't affect the behaviour of dragging tiddler links between TiddlyWiki windows)
Hackability Improvements
Added additional theme tweaks for the body text size and line height
Updated structure of widget messages that have a hashmap parameter
The support for nested popups has necessitated a change in the way that popups are styled that affects popups that are triggered with the focusPopup attribute of the EditTextWidget: it is now necessary for the widget to be given the class tc-popup-handle.
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Cette version intègre plusieurs améliorations à la documentation de TiddlyWiki. Tous mes remerciements à tous ceux qui y ont contribué, et spécialement à notre prodigieux nouveau contributeur Astrid Elocson.
Améliorations linguistiques
Amélioration des traductions Française, Danoise, Chinoise et Japonaise
Migre la fonctionnalité "Titres Stickés", par un réglage optionnel, des thèmes "Vanilla"/"Snow White". Ainsi les titres des tiddlers collent au haut de la fenêtre pendant le défilement pour les navigateurs qui l'acceptent position: sticky (comme Safari et Firefox)
@Jermolene tient à remercier tous les contributeurs de cette version qui ont généreusement donné de leur temps pour aider à l'amélioration de TiddlyWiki:
An experimental plugin to add a simple "Powered by TiddlyWiki" banner to your site. It is included in this prerelease but will not be on the main tiddlywiki.com wiki.
New "Fluid story, fixed sidebar" mode
It is now possible to arrange the main window so that the sidebar has a fixed width and the story river expands to fill the remaining space.
To switch it on, visit Theme Tweaks in the $:/ControlPanelAppearance tab and use the following options:
Sidebar layout:
Fixed story, fluid sidebar (default) - the story river has a fixed width and the sidebar fills the remaining space
Fluid story, fixed sidebar - the story river expands to fill horizontal space remaining after the fixed width sidebar
Sidebar width:
The width of the sidebar. Can be specified in pixels (eg 350px), a percentage (eg 25%) or other CSS unit
Toolbar Button Style Setting
A new setting in $:/ControlPanelSettings tab allows the toolbar button style to be chosen from the following options:
the existing style
, which adds a thin border box around the button
, which rounds the button corners and inverts the button colours
Plugins can add new style options.
New Tiddler Toolbar Button: "Open in new window"
An experimental new tiddler toolbar button opens a single tiddler in a separate pop-up browser window. The tiddler will be dynamically updated just as in the main window. There are several uses:
Arranging reference tiddlers for easy access while editing in the main window
Making good use of multi-screen layouts
Printing the content of a single tiddler
Running presentations in a separate window while maintaining notes in the main window
Improvements for visually impaired users
Improved monochrome palette variants:
. Foreground: , Background:
. Foreground: , Background:
New "Solar Flare" palette
There's a new core palette "Solar Flare", contributed by Rustem Akbulatov (@nameanyone).
Options for Story Control
There are new options for controlling the position in the story river of newly opened tiddlers. Visit the Settings tab of $:/ControlPanel and look for "Tiddler Opening Behaviour".
Congratulations to Frank. B for his winning design for the banner for this release (here are the other entries).
Highlights
Unrestricted Fieldnames and the New JSON Store Area
The major change in this release is that the format used to store tiddlers in TiddlyWiki's HTML file has changed from an HTML DIV-based format to a new JSON-based format. The consequences of this change are far-reaching. They are thus the primary rationale for bumping the version number from v5.1.x to v5.2.0:
Firstly, the characters that can be used in field names are now unrestricted (just like tiddler titles), making it possible to use fieldnames like My^Field or ☃️. This has become possible because every other part of TiddlyWiki was already capable of dealing with unrestricted field names apart from saving as an HTML file.
Secondly, external tools that read, write or otherwise process TiddlyWiki HTML files will need modification to understand the new store area format. The details are documented in the /dev wiki.
It is now possible to drag and drop an image file directly into the tiddler text editor. A popup allows the incoming image tiddler to be renamed, and then [img[title]] is automatically inserted into the tiddler text at the insertion point.
ajouté (and again here) ability to drag and drop images directly in the editor
It is now possible to embed actions within the body of the ActionCreateTiddlerWidget, and those actions can directly access the title of the newly created tidddler via the variable createTiddler-title, and the title of the corresponding draft in the variable createTiddler-draftTitle. The old $savetitle and $savedrafttitle attributes are now deprecated.
<$button>
<$action-createtiddler $basetitle="Homemade Button" tags="$:/tags/PageControls" text={{$:/state/new-button-caption}}>
<$action-navigate $to=<<createTiddler-title>>/>
</$action-createtiddler>
Create a new non-functional page control button and open the tiddler
</$button>
This simple-sounding change has several important consequences:
The first consequence is that it makes the TranscludeWidget much more efficient, and improves the performance of the refresh cycle.
The second consequence resolves a long-standing difficulty for many users: it is now possible to use an EditWidget to edit another field of the same tiddler. Previously, the edit widget would not work properly in such cases because it would be refreshed on every keypress, leading to the current editing caret/selection position being lost.
As sometimes happens, the third consequence is that constructions that relied on the old, buggy behaviour may no longer work as expected. A common example of such a construction is an invocation of a JavaScript macro. The problem stems from the fact that JavaScript macros are designed to be as simple as possible from the developers perspective, being pure functions that have no side effects, and that always return the same value for the same parameters. In particular, JavaScript macros cannot participate in TiddlyWiki's refresh mechansim, so they cannot force themselves to be updated when underlying data changes (for situations where such processing is needed, JavaScript widgets should be used instead of JavaScript macros).
However, developers have sometimes worked around this limitation by using the TranscludeWidget to force refreshing of a macro invocation when a particular tiddler changes. The newer, more selective behaviour means that sometimes such widgets will avoid a refresh that was previously relied upon to update the JavaScript macro.
For end users, if an upgrade to v5.2.0 causes problems then consult the discussion Forums to see if other users have encountered the same problem, and make a new posting if needed.
amélioré the TranscludeWidget to avoid triggering a refresh unless the transcluded field changes (previously it was also triggered for changes to other fields)
Other Notable Improvements
étendu (and here) the ListWidget with an optional counter attribute specifying a variable to contain the numeric index of each list item. This is useful for creating a list of numbered items, and for detecting the first and last entries in a list
étendu action widget execution with an optional new mode that ensures that all widgets are refreshed before invocation – see ActionWidget Execution Modes. This resolves a long-standing inconsistency in the way that ActionWidgets are executed, making them behave much more like a conventional programming language
amélioré the HTML comment syntax to enable it to be used before and in between pragmas such as macro definitions. This makes it much easier to provide documentation within complex wikitext tiddlers
corrigé size of dropzone when story river is empty. For a long time, TiddlyWiki confusingly wouldn't recognise a drag and drop operation if the story river was empty
Performance Improvements
amélioré (and again here) the efficiency of the linked list implementation used in filter processing
étenduDropzoneWidget to optionally invoke actions after the tm-import-tiddlers message has been sent, and to specify an optional contentTypesFilter which determines which content types are accepted by the dropzone.
étenduDropzoneWidget to also use the specified deserializer for strings either dropped or pasted on to the dropzone
The cascade mechanism provides a flexible way to choose between multiple options. Crucially, it is done in a way that makes it simple for plugins to tweak the logic or add their own options.
Some of the things that can be done with cascades are:
Replacing the default tiddler body template with a custom one for a certain type of tiddler
Giving all journal tiddlers a custom icon
Implementing a custom editor for certain types of tiddler
There are two parts to these changes. The underpinning is a new Cascade Filter Run Prefix that takes a list of filters and runs them in order, returning the result of the first one to return a value.
The second part is a series of improvements based on this new filter cascade mechanism. Conditional logic that was previously hidden within core templates can now be extended and tweaked much more easily than before.
Choosing the following elements of the core user interface is now handled with cascades:
The LetWidget is an improved alternative to the existing VarsWidget. It is recommended to use the new LetWidget instead of the VarsWidget in all circumstances.
The chief advantage is that the LetWidget performs the variable assignments in the same order as they are written, and permits references to earlier assignments. For example, here we swap the values of two variables:
This is a major upgrade to the latest version of highlight.js. The new version has many improvements, including better support for Fortran.
The new version of the Highlight Plugin requires a modern browser that fully supports JavaScript ES6 (released in 2015). The older version is still available as the highlight-legacy plugin for users who need to use an older browser.
ajouté support for line breaks within filtered transcluded attributes
To improve readability, it is now possible to use newlines as whitespace within filtered transcluded attributes of HTML elements and widgets. For example:
This was a long standing bug that manifested itself in several ways.
The root cause was that the order in which tiddlers were enumerated depended upon the order in which they had been added to the store.
The effect was that lists based on enumerating tiddlers would show different results depending upon whether new tiddlers were added since the wiki was reloaded.
For example, adding a new tiddler with a given tag previously caused the new tiddler to appear at the bottom of the tag pill listing for that tag. Saving and reloading the wiki would reorder the list to put the new tiddler in the correct position.
The fix ensures that the enumeration order remains consistent.
corrigé some incorrectly nested <span> and <div> elements
TiddlyWiki's core page layout has historically included several instances of inline <span> elements containing block <div> elements, something that is technically invalid HTML. In practice, browsers have always handled these cases leniently to make the page work but it has also been unhelpful for developers to encountering invalid HTML constructions in their first interactions with TiddlyWiki.
The immediate prompt for starting to fix these issue now is that Chrome v100 includes a change that causes some of these misnested elements to be rendered correctly visually but to be unclickable in some situations. (The change is reverted in Chrome v102, but it still makes sense to fix it)
Plugin Improvements
corrigé issue with LaTeX content within Markdown tiddlers
corrigé incorrect handling of dropdown classes in the menu bar plugin
After the release of v5.2.5, we found some backwards compatibility issues with the stylesheet changes in #7039 and #6910. We have therefore decided to make a rapid bug fix Release 5.2.5 to resolve these issues, and all users should upgrade to the new version.
Major Improvements
New Twitter Archivist plugin to import the tweets and associated media from a Twitter Archive as individual tiddlers.
ajouté new GenesisWidget that allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance
This is a bug fix release intended to resolve backwards compatibility issues discovered in v5.2.4. See this GitHub ticket for the background.
The issues are entirely cosmetic stylesheet changes, and do not affect the functionality of TiddlyWiki. However, we encourage all users to upgrade to this new version for consistency.
Since v5.2.5 replaces v5.2.4 that was only released for a week, here is the release note for v5.2.4.
After the release of v5.2.5, we found some backwards compatibility issues with the stylesheet changes in #7039 and #6910. We have therefore decided to make a rapid bug fix Release 5.2.5 to resolve these issues, and all users should upgrade to the new version.
Major Improvements
New Twitter Archivist plugin to import the tweets and associated media from a Twitter Archive as individual tiddlers.
ajouté new GenesisWidget that allows the dynamic construction of another widget, where the name and attributes of the new widget can be dynamically determined, without needing to be known in advance
mis à jour the Markdown Plugin to use the newer and better maintained markdown-it library. The previous Markdown plugin remains available as "markdown-legacy"
Better Handling of Loss of Network Connectivity with Client Server Configuration
ajouté integration between the BrowserStorage Plugin and the client-server configuration to allow changes to be made while offline and then later resynchronised with the server
New Diff-Match-Patch Primitives
ajouté three new operators exposing previously hidden features of the Diff-Match-Patch library that is integrated with TiddlyWiki:
new levenshtein Operator to calculate the similarity of two strings as the number of characters that need to be inserted, deleted or modified in order to turn one into the other
This is a bug fix release intended to resolve a backwards compatibility issue discovered in v5.2.6. See this GitHub ticket for the background.
The issue is that trailing newlines within a macro definitions were being ignored, which affected whether the content were parsed in inline or block mode.
Since v5.2.7 replaces v5.2.6 that was only released for less than a week, here is the release note for v5.2.6.
mis à jour the Markdown Plugin to use the newer and better maintained markdown-it library. The previous Markdown plugin remains available as "markdown-legacy"
Better Handling of Loss of Network Connectivity with Client Server Configuration
ajouté integration between the BrowserStorage Plugin and the client-server configuration to allow changes to be made while offline and then later resynchronised with the server
New Diff-Match-Patch Primitives
ajouté three new operators exposing previously hidden features of the Diff-Match-Patch library that is integrated with TiddlyWiki:
new levenshtein Operator to calculate the similarity of two strings as the number of characters that need to be inserted, deleted or modified in order to turn one into the other
Congratulations to vilc for their winning design for the banner for this release (here is the competition thread).
Overview of v5.3.0
This release introduces a number of significant improvements and new features related to some of TiddlyWiki's most fundamental components: macros, widgets, operators and transclusion. v5.3.0 also contains several other bug fixes and improvements.
Introduction to Parameterised Transclusion, Procedures, Functions and Custom Widgets
ajouté The motivation of these changes is to fix one of TiddlyWiki 5's early design flaws: the reliance on macros using textual substitution as the primary way to modularise and reuse wikitext and filters.
Experience has shown that while macros are a good match for a small number of tasks, they are brittle and error prone for many common operations. See Macro Pitfalls for a discussion of the problems that accompany this approach. Over the years we have introduced mitigations for the worst problems but these have come at a cost of increased complexity.
The changes in this release provide powerful new ways to achieve common tasks, and unlock completely new capabilities that were previously impossible in wikitext.
Procedures, which are essentially what macros should have been; they work in exactly the same way except that parameters are exposed as simple variables (without the double underscores) and no textual substitution takes place
Custom Widgets, allowing the creation of widgets in wikitext, and the redefinition of built-in widgets
Functions, a new way to encapsulate filter expressions with named parameters, including the ability to make custom filter operators
Parameterised Transclusions, allowing strings and wikitext trees to be passed to transclusions
The approach taken by this release is to add new functionality by extending and augmenting the system without disturbing existing functionality. All of these changes are thus intended to be backwards compatible. While they represent a new field of opportunities for wikitext authors, it is possible for authors to ignore all these new features and continue to use TiddlyWiki 5 in the way that they have always done.
These changes lay the groundwork for macros and related features to be deprecated (which is the point at which users are advised not to use old features, and instead given clear pointers to the equivalent modern functionality).
Text Substitution Improvements
ajouté The new transclusion architecture is not by itself sufficient to enable us to fully deprecate macros yet. To handle most of the remaining use cases this release adds convenient new ways of using textual substitution without having to create a macro:
Firstly, the new text substitution syntax for widget attributes allows widget attributes to be assigned the value of a string with certain placeholders being replaced by their processed contents. For example:
Substitute variable names with the value:
attr=`Current tiddler is $(currentTiddler)$`
Substitute filter expressions with the first value they return:
attr=```There are ${ [tag[Done]count[]] }$ completed tasks```
Secondly, the new substitute operator allows the same textual substitutions to be performed via a filter operator with the addition of positional parameters that use placeholders of the form $1$, $2$, $3$ etc.
mis à jourCamelCase linking is now disabled by default for new wikis. (Note that this documentation wiki has CamelCase linking explicitly enabled because much of the old content was written relying on them).
Plugin Improvements
mis à jour Google Analytics plugin to use new GA4 code. Note that the update requires manual configuration to use the new "measurement ID" instead of the old "account ID"
étendu Dynannotate pugin to support three additional search modes
Congratulations to vilc for their winning design for the banner for this release (here is the competition thread).
Overview of v5.3.1
This release comes only a few weeks after v5.3.0. The motivation for the release is to swiftly fix some issues that have emerged with v5.3.0. There are also some other improvements included in this release, notably the ability to access binary resources over HTTP – the demo downloads a random image or video of a dog.
Congratulations to vilc for their winning design for the banner for this release (here is the competition thread).
Overview of v5.3.1
This release comes only a few weeks after v5.3.0. The motivation for the release is to swiftly fix some issues that have emerged with v5.3.0. There are also some other improvements included in this release, notably the ability to access binary resources over HTTP – the demo downloads a random image or video of a dog.
Exécute le contenu des tiddlers individuels identifiés par un filtre et enregistre le résultat vers les fichiers spécifiés.
Optionellement, on peut spécifier le titre d'un tiddler modèle (template). Dans ce cas, au lieu d'exécuter directement le contenu de chaque tiddler, le modèle est exécuté après avoir donné pour valeur à la variable "currentTiddler" le titre du tiddler dont le contenu est en cours d'exécution.
On peut spécifier le nom et la valeur d'une variable supplémentaire.
filtre-sur-les-tiddlers: Un filtre qui indentifie les tiddlers dont le contenu doit être exécuté
filtre-des-noms-de-fichier: filtre optionnel pour transformer les titres de tiddlers en chemin de fichiers. À défaut, le filtre utilisé est [is[tiddler]addsuffix[.html]], qui utilise le titre inchangé du tiddler comme nom de fichier
modèle: Modèle optionnel via lequel chaque tiddler doit être rendu
type-de-rendu: Type de rendu optionnel : la valeur text/html (par défaut) retourne le text HTML complet et text/plain se contente de retourner le contenu sous forme texte (autrement dit ignore les balises HTML et autres caractères non imprimables)
nom: Nom des variables optionnelles
valeur: Valeur des variables optionnelles
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à diriger les sorties vers un répertoire différent.
Notes :
Les éventuels fichiers présents dans le répertoire de sortie ne sont pas supprimmés
Les répertoires absents dans le chemin de fichier sont créés automatiquement.
Lorsqu'un tiddler contient des espaces dans le titre, prendre garde à utiliser aussi bien les guillemets nécessaires au shell et les doubles crochets droits propres à TiddlyWiki : --render "[[Motovun Jack.jpg]]"
Le filtre des noms de fichier est évalué après avoir initialisé l'élément d'entrée avec le titre du tiddler en cours d'exécution, permettant ainsi d'utiliser le titre comme base de calcul pour le nom de fichier. Par exemple [encodeuricomponent[]addprefix[static/]] applique un encodage d'URI à chaque titre, puis ajoute le préfixe static/
Il est possible d'utiliser plusieurs paires nom/valeur pour passer plus d'une variable
La commande --render remplace de manière plus souple les deux commandes --rendertiddler et --rendertiddlers, qui sont du même coup obsolètes.
Exemples :
--render "[!is[system]]" "[encodeuricomponent[]addprefix[tiddlers/]addsuffix[.html]]" – enregistre le rendu HTML de tous les tiddlers non-système vers des fichiers du sous-répertoire "tiddlers", nommés après encodage URL des titres et ajout d'une extension html.
--render '.' 'tiddlers.json' 'text/plain' '$:/core/templates/exporters/JsonFile' 'exportFilter' '[tag[HelloThere]]' – enregistre le rendu JSON des tiddlers tagués "HelloThere" dans un fichier nommé "tiddlers.json"
(À noter : la commande --rendertiddler est dépréciée. Il est préférable d'utiliser la nouvelle commande --render, plus souple)
Enregistre vers le chemin indiqué le résultat de l'exécution d'un tiddler pour le type de contenu (ContentType) spécifié — par défaut text/html.
Un tiddler modèle (template) peut être indiqué optionnellement. Dans ce cas, le tiddler modèle est exécuté après initialisation de la variable "currentTiddler" avec le tiddler dont le titre est donné en premier paramètre de la commande.
Le nom et la valeur d'une variable supplémentaire peuvent être spécifiés optionnellement.
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à rediriger la sortie vers un répertoire différent.
Les répertoires présents dans le chemin du fichier et qui n'existent pas encore sont créés automatiquement.
Par exemple, la commande ci-dessous enregistre tous les tiddlers correspondant au filtre [tag[done]] vers un fichier JSON de nom output.json, en faisant appel au template prédéfini $:/core/templates/exporters/JsonFile.
(À noter : la commande --rendertiddlers est dépréciée. Il est préférable d'utiliser la nouvelle commande --render, plus souple)
Enregistre vers le chemin indiqué et avec l'extension indiquée — par défaut .html, le résultat de l'exécution d'un ensemble de tiddlers (sélectionnés par un filtre). Le résultat de l'exécution est rendu selon le type de contenu (ContentType) spécifié — par défaut text/html :
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à rediriger la sortie vers un répertoire différent.
Tous les fichiers du répertoire cible sont supprimés, sauf si le drapeau noclean est spécifié. Le répertoire cible est créé récursivement s'il n'existe pas.
Vous pouvez signaler les bogues et les problèmes rencontrés avec TiddlyWiki sur nos groupes de discussions. Si vous avez un compte GitHub vous pouvez aussi le faire là :
Nous utilisons le processus de questions sur GitHub pour gérer les rapports de bugs et demandes de fonctionnalités pour TiddlyWiki. Pour maintenir leur efficacité nous nous efforçons d'avoir aussi peu de questions en suspens que possible.
Politique de gestion des questions
Les questions en suspens se traduisent généralement : soit par un rapport de bogue reproductible, soit par une demande de fonctionnalité spécifique. Du point de vue des développeurs du noyau, la liste des questions se présente comme une liste de tâches partagée. Chaque élément de la liste demande un peu d'attention à chaque fois que nous vérifions la liste.
Les questionnements GitHub ne sont pas très efficaces pour gérer les idées qui ne sont pas réalisables immédiatement. Mieux vaut utiliser les forum TiddlyWiki pour les questions ouvertes, ou les discussions spéculatives sur de nouvelles fonctionnalités.
Soumettre une question
Avant de soumettre une question sur GitHub, il est de bon ton de chercher dans les questions existantes pour déterminer si le problème n'aurait pas déjà été posé. Si la recherche ne vous semble pas pratique, ne vous inquiétez pas trop ; Avec GitHub, il est facile de fusionner les questions existantes.
Lorsque vous devez soumettre un problème, gardez en mémoire que nous avons besoin du plus d'informations possibles pour une résolution efficace. Au minimum, veuillez essayer d'inclure :
Un titre descriptif
Un résumé
Étapes à reproduire
Comportement attendu
Contexte (OS, Navigateur, etc.)
Pensez également à ajouter des captures d'écran si cela peut rendre les choses plus claires.
Il y a beaucoup de bon matériel sur le web au sujet du signalement des bogues :
The resolvepath macro takes a relative path and an absolute path. It interprets the former relative to the latter, and returns the absolute equivalent of the former.
Folders in the paths are delimited by /.
The special folder name . denotes the current folder, and .. denotes the parent folder.
If the absolute path indicates a folder, it needs to end with /. Anything after the final / is treated as an arbitrary filename within the intended path, and is discarded.
If no absolute path is supplied, the relative path is returned unchanged, except that anything after the final / is discarded.
The return value is a path, but does not end with /.
Voici quelques sites contenant des ressources créées par la communauté TiddlyWiki, pour vous aider à tirer le meilleur de TiddlyWiki : plugins, macros etc. N'hésitez pas à proposer de nouvelles ressources via GitHub, Twitter ou en postant sur les groupes de discussion TiddlyWiki.
TiddlyWiki for Scholars est une personnalisation de TiddlyWiki 5.0.13-beta, que j'ai écrite en pensant à la prise de notes à partir de lectures, mais qui peut servir à d'autres choses. L'idée est de montrer et de faciliter la création des données liées au tiddler courant sans quitter le tiddler.
Ce guide de prise en main de TiddlyWiki vous permettra de débuter sur ce logiciel : rédiger du texte avec la syntaxe wiki, insérer des images, créer des Tiddler, faire une recherche, ajouter des fonctionnalités, et bien d'autres choses.. Bonne lecture ! Sylvain
buggyj a créé plusieurs plugins utiles, notamment un éditeur HTML WYSIWYG, un calendrier configurable et des listes de tags réagençables par simple glisser-déplacer.
Une collection de diverses personnalisations et macros, par Danielo Rodriguez.
Ceci est mon fichier tiddlywiki de test personnel.
Ici, je posterai les outils et macros que je développe pour ce merveilleux outil. Ainsi, toute l'aide que j'ai reçue de la communauté retourne à la communauté.
The reveal widget hides or shows its content depending upon the value of a state tiddler. The type of the widget determines the condition for the content being displayed:
type=match: the content is displayed if the state tiddler matches a specified value
type=nomatch: the content is displayed if the state tiddler doesn't match a specified value
type=popup: the content is displayed as a popup as described in the PopupMechanism
Content and Attributes
The content of the <$reveal> widget is displayed according to the rules given above.
Attribute
Description
state
The title of the tiddler containing the state
type
The type of matching performed: match, nomatch or popup
text
The text to match when the type is match and nomatch
position
The position used for the popup when the type is popup. Can be left, above, aboveright, right, belowleft or below
default
Default value to use when the state tiddler is missing
animate
Set to "yes" to animate opening and closure (defaults to "no")
retain
Set to "yes" to force the content to be retained even when hidden (defaults to "no")
Retaining the content when hidden can give poor performance since the hidden content requires refresh processing even though it is not displayed. On the other hand, the content can be revealed much more quickly. Note that setting animate="yes" will also force retain="yes".
Examples
Simple content reveal
Here's a simple example of showing and hiding content with buttons:
<$button set="$:/state/SampleReveal1" setTo="show">Show me</$button>
<$button set="$:/state/SampleReveal1" setTo="hide">Hide me</$button>
<$reveal type="match" state="$:/state/SampleReveal1" text="show">
! This is the revealed content
And this is some text
</$reveal>
Affichera ceci :
"Slider"
A slider appears as a single button that can be used to toggle the display of the contained content.
<$reveal type="nomatch" state="$:/state/SampleReveal2" text="show" animate="yes">
<$button set="$:/state/SampleReveal2" setTo="show">Show me</$button>
</$reveal>
<$reveal type="match" state="$:/state/SampleReveal2" text="show" animate="yes">
<$button set="$:/state/SampleReveal2" setTo="hide">Hide me</$button>
! This is the revealed content
And this is some text
</$reveal>
Affichera ceci :
Popup
Here is a simple example of a popup built with the RevealWidget:
<$button popup="$:/SamplePopupState">Pop me up!</$button>
<$reveal type="popup" state="$:/SamplePopupState">
<div class="tc-drop-down">
! This is the popup
And this is some text
</div>
</$reveal>
Le Mode Sans Échec permet de désactiver la plupart des personnalisations de TiddlyWiki. Il est nécessaire car certaines personnalisations incorrectes de TiddlyWiki peuvent le rendre inutilisable. Dans un cas particulier, certaines personnalisations échouaient lors du passage à une nouvelle version du noyau de TiddlyWiki (notamment lors de la version beta).
Activer le Mode Sans Échec
Le Mode Sans Échec est activé en faisant précéder le lien URL de TiddlyWiki dans le navigateur par la chaine #:safe. Par exemple :
Tous les plugins sont momentanément désactivés. Vous pouvez alors utiliser le control panel pour désactiver des plugins.
Les tiddlers qui modifient les tiddlers shadows sont renommés avec le préfixe SAFE: , ce qui a pour effet de restaurer les tiddlers shadows sous-jacents.
Un tiddler rapport est affiché pour vous permettre d'examiner les tiddlers renommés.
filtre-des-tiddlers: Un filtre identifiant les tiddlers à enregistrer
filtre-des-noms-de-fichiers: Filtre optionnel pour transformer les titres de tiddlers en chemins de fichiers. À défaut, le filtre utilisé est [is[tiddler]], qui utilise le titre inchangé du tiddler comme nom de fichier
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du réepertoire de l'édition. La commande --output peut servir à diriger les sorties vers un répertoire différent.
Notes :
Les éventuels fichiers présents dans le répertoire de sortie ne sont pas supprimmés
Les répertoires absents dans le chemin de fichier sont créés automatiquement.
Lorsqu'un tiddler contient des espaces dans le titre, prendre garde à utiliser aussi bien les guillemets nécessaires au shell et les doubles crochets droits propres à TiddlyWiki : --render "[[Motovun Jack.jpg]]"
Le filtre des noms de fichier est évalué après avoir initialisé l'élément d'entrée avec le titre du tiddler en cours d'exécution, permettant ainsi d'utiliser le titre comme base de calcul pour le nom de fichier. Par exemple [encodeuricomponent[]addprefix[static/]] applique un encodage d'URI à chaque titre, puis ajoute le préfixe static/
La commande --save remplace de manière plus souple les deux commandes --savetiddler et --savetiddlers, qui sont du même coup obsolètes.
Exemples :
--save "[!is[system]is[image]]" "[encodeuricomponent[]addprefix[tiddlers/]]" – enregistre tous les tiddlers images non-système comme des fichiers du sous-répertoire "tiddlers" nommés après encodage URL des titres.
(À noter : la commande --savetiddler est dépréciée. Il est préférable d'utiliser la nouvelle commande --save, plus souple)
Enregistre un tiddler texte ou binaire dans le fichier spécifié, sous sa forme brute.
--savetiddler <titre> <chemindufichier>
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à rediriger la sortie vers un répertoire différent.
Les répertoires présents dans le chemin du fichier et qui n'existent pas encore sont créés automatiquement.
Par défaut, le répertoire de sortie est calculé relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à diriger la sortie vers un répertoire différent.
Les fichiers présents dans le répertoire de sortie sont supprimés avant que soient enregistrés les fichiers des tiddlers spécifiés par le filtre. Pour empêcher cette suppression, ajouter le drapeau noclean.
Les éventuels répertoires manquants dans le chemin spécifié sont créés automatiquement.
This plugin causes TiddlyWiki to continuously download (as a JSON file) the contents of any tiddler that is manually changed by any of several means:
Confirming an edit
Deleting tiddlers
Imports
Renames/relinks
Optionally, typing in draft tiddlers can trigger a download
Where appropriate, separate 'before' and 'after' files are downloaded. Configured correctly, the browser will download the files silently in the background, and they can be used as a backup in case of accidental data loss.
Depuis : 5.1.20 Enregistre le wiki courant sous la forme d'un dossier wiki, comprenant les tiddlers, les plugins et les informations de configuration :
--savewikifolder <chemindudossierwiki> [<filtre>]
Le dossier wiki cible doit être vide ou inexistant
Le filtre spécifie les tiddlers à inclure. Il est optionnel et vaut par défaut [all[tiddlers]]
Les plugins appartenant à la bibliothèque officielle de plugins sont remplacés par des références à ces plugins dans le fichier tiddlywiki.info
Les plugins sur mesure sont déballés dans leur propre dossier
On utilise typiquement cette commande avec la commande --load pour convertir un fichier TiddlyWiki HTML en un dossier wiki :
L'enregistreur intégré TiddlySpot peut aussi être utilisé pour enregistrer vos modifications vers un simple script PHP que vous pouvez exécuter sur la plupart des hébergeurs PHP.
Ce code n'a pas été mis à jour depuis de nombreuses années. Si vous rencontrez des difficultés, considérez l'utilisation de TW Receiver à la place
Extrayez une copie de store.php du sous-répertoire _th\lib
Éditez votre copie de store.php pour ajouter vos nom d'utilisateur et mot de passe. Trouvez la ligne $USERS = array( 'UserName1'=>'Password1', etc) et remplacez Username1 et Password1 par vos propres nom d'utilisateur et mot de passe.
Assurez vous de laisser intacts le code et la ponctuation, comme les simple cotes (')
Enregistrez le fichier
A l'aide de FTP ou de votre interface web, téléversez le fichier store.php sur votre serveur. Assurez-vous que le nom de fichier est correct.
Si tout est conforme vous devriez pouvoir accéder au fichier dans votre navigateur (p.ex. http://example.com/store.php)
Dans TiddlyWiki, affichez l'onglet Sauvegarde du panneau de contrôle et saisissez les informations suivantes :
Votre nom d'utilisateur en tant que nom de wiki
Votre mot de passe
l'URL du fichier store.php (pas l'URL du wiki, mais l'URL complète d'accès au fichier store.php)
L'onglet Sauvegarde du panneau de contrôle inclut les paramètres suivants :
Nom
Description
URL du serveur
URL complète du fichier store.php sur votre serveur
Nom du fichier téléversé
Le nom de fichier utilisé pour enregistrer le TiddlyWiki (index.html par défaut)
Dossier de téléversement
Le chemin relatif entre store.php et le dossier d'enregistrement du fichier
Dossier de sauvegarde
Le chemin relatif entre store.php et le dossier de sauvegarde
Note sur la taille maximale
Quand la taille de votre fichier TW augmentera, vous devrez modifier le fichier .htaccess (ou htaccess selon le système) pour augmenter la taille maximale de téléversement et/ou de POST. Vérifiez avec votre hébergeur les réglages possibles. Assurez-vous de disposer de sauvegardes avant d'expérimenter avec les réglages. Exemple de réglages :
Si vous rencontrez un message d'erreur concernant split(), vous pourriez avoir à remplacer les appels à split() dans store.php par la fonction explode.
Les applications Tiddloid et Tiddloid Lite sont des applis Android qui permettent d'éditer des wikis et d'enregistrer les changements au format HTML de TiddlyWiki.
Créez des nouveaux wikis à partir de la dernière version de TiddlyWiki publiée sur internet
Importez des TiddlyWiki existants stockés sur la mémoire interne de l'appareil. (TiddloidLite permet aussi le stockage sur carte SD externe)
Copiez et personnalisez des TiddlyWiki intéressants à partir d'internet (fonctionne avec TW5 uniquement)
Détection de TiddlyWiki
Les TiddlyWiki stockés localement sont mis à jour en même temps que l'enregistrement des modifications dans les TiddlyWiki importés dans l'appli.
Système de sauvegarde compatible avec celui de TiddlyDesktop
Raccourcis vers vos wikis sur la page d'accueil d'Android
TiddloidLite est compatible avec le stockage en nuage comme GDrive ou OneDrive.
Notes
Tiddloid Lite fonctionne mieux sur les appareils munis d'Android Q ou ultérieur. Il permet aussi le stockage en nuage dans GDrive ou OneDrive, alors que Tiddloid conserve la compatibilité avec TiddlyWiki Classic. Pour en apprendre plus sur les différences entre Tiddloid et Tiddloid Lite, consultez la page d'accueil de Tiddloid.
Pour que l'importation fonctionne correctement, conservez l'extension .html ou .htm de vos fichiers TiddlyWiki.
Cette API n'est pas complètement standardisée, cette méthode d'enregistrement est par conséquent assez expérimentale.
L'API utilisée par cet enregistreur fonctionne avec la plupart des navigateurs basés sur Chromium. Voir caniuse pour les informations actualisées sur sa disponibilité dans les navigateurs.
Tiddlystow saves TiddlyWiki files locally using the browser file system API (Chrome-based browsers currently).
This is a simple web page for loading a local TiddlyWiki file and storing it back to the same local file requiring no plugins or extensions.
L'application Quine 2 pour iPad/iPhone permet d'éditer et d'enregistrer les modifications de wikis TiddlyWiki5 sur iOS. Vous pouvez la télécharger ici.
Instructions d'utilisation :
Ouvrez Quine 2
Tapez sur le bouton + de la barre d'outils pour créer et ouvrir un nouveau TiddlyWiki
Dans la liste des fichiers tapez sur un fichier TiddlyWiki existant pour l'ouvrir
Éditez le TiddlyWiki comme d'habitude, et enregistrez-le normalement avec Autosave ou le bouton enregistrer
Utilisez le bouton de barre d'outil Documents à gauche pour fermer un TiddlyWiki ouvert
Quine 2 fonctionne nativement sous iOS avec des fichiers locaux ou stockés dans iCloud
Quine 2 permet aussi d'ouvrir, modifier et enregistrer des fichiers TiddlyWiki stockés chez d'autres fournisseurs de service Cloud
Quine 2 permet de suivre des liens Wikitexte embarqués ou des liens canoniques externes vers des fichiers accessibles comme sur le Cloud via des services compatibles avec le folder level sharing
Parmi les applications compatibles, citons Secure Shellfish et Working Copy. La plupart des services ne permet toutefois pas aux applis comme Quine 2 d'utiliser ce type de liens
Si vous voulez activer cette fonctionnalité pour les services « collaboratifs », basculez le commutateur Autoriser la sélection de dossiers pour les liens hors bac-à-sable dans les paramètres iOS de Quine 2
Notez que Quine 2 est publié indépendamment de TiddlyWiki
AndroidChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaPHPSafariEnregistrer les modificationsWindows
TiddlyHost.com est un service d'hébergement pour TiddlyWiki créé par Simon Baird. Après vous être inscrit et avoir confirmé votre courriel vous pourrez créer des « sites » (c-à-d des TiddlyWiki), que vous pourrez enregistrer en ligne. Les sites peuvent être privés ou publics, et vous pouvez éventuellement les référencer, les taguer et rechercher sur le Hub TiddlyHost où ils seront accessibles aux autres.
Contrairement à TiddlySpot, TiddlyHost est sécurisé, open source, et compatible avec TiddlyWiki5. Il permet aussi de téléverser des fichier TiddlyWiki existants, est compatible avec TiddlyWikiClassic, et vous permet de revendiquer la propriété de vos sites TiddlySpot . Pour plus d'informations lisez la FAQ et la page A propos.
AndroidChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaPHPSafariEnregistrer les modificationsWindows
Attention ! TiddlySpot est passé en mode maintenance et ne permet plus de créer de nouveau site. Vous pouvez maintenant utiliser TiddlyHost à la place, un nouveau service proposé par le créateur de TiddlySpot.
TiddlySpot est un service d'hébergement gratuit pour les documents TiddlyWiki, mis à disposition par Simon et Daniel Baird. Le plus simple pour commencer est de créer un nouveau wiki sur http://tiddlyspot.com – par défaut, vous obtiendrez la dernière version de TiddlyWiki Classic.
Vous pouvez publier un document TiddlyWiki depuis votre disque local vers TiddlySpot en suivant les étapes ci-dessous :
Demandez la création d'un nouveau wiki sur http://tiddlyspot.com/, et rappelez-vous son nom et son mot de passe
Ouvrez le fichier TiddlyWiki conservé localement dans votre navigateur
Remplissez le nom et le mot de passe TiddlySpot dans l'onglet Sauvegarde du panneau de contrôle
Cliquez sur le bouton « Enregistrer les modifications » dans la barre latérale. Vous devriez voir un message de confirmation en haut à droite de la barre latérale indiquant Wiki enregistré. Cela peut durer plusieurs secondes si vous avez une connexion lente ou si vous travaillez avec un wiki volumineux.
Ouvrez votre wiki TiddlySpot à l'URL http://<nom-du-wiki>.tiddlyspot.com/
Notez que lorsque vous utilisez TiddlySpot, votre mot de passe est envoyé non-crypté. Extrait de http://faq.tiddlyspot.com/ :
Tiddlyspot est-il sûr ?
Non. Tiddlyspot n'utilise pas SSL/https. Votre mot de passe est envoyé en clair lorsque vous enregistrez votre wiki et au moment où vous vous authentifiez pour accéder à un site privé. Autrement dit, votre Tiddlyspot est ouvert aux renifleurs de paquets et votre mot de passe peut être découvert par un tiers malveillant. De même, vos données sont transmises non
-cryptées lorsque vous vous affichez votre site, même s'il s'agit d'un site privé. C'est pourquoi nous vous prions instamment de ne pas conserver d'informations sensibles comme des données bancaires dans votre Tiddlyspot et de ne pas utiliser un mot de passe que vous utilisez pour d'autres sites plus sensibles.
Problèmes lors de la sauvegarde sur Tiddlyspot
Si vous rencontrez l'erreur suivante au moment de déposer un nouveau TiddlyWiki (ou mis à niveau) vers Tiddlyspot à partir d'un fichier local :
Error while saving:
Error:NS_ERROR_DOM_BAD_URI: Access to restricted URI denied
L'opération tombe sous le coup d'une restriction de sécurité propre à Firefox. En attendant que cela puisse être résolu, nous suggérons d'utiliser Chrome pour effectuer cette opération :
Utilisez Chrome pour ouvrir le document TiddlyWiki local que vous voulez déposer sur TiddlySpot et suivez les étapes 1 à 5 ci-dessus
Après avoir vérifié que le TiddlyWiki hébergé sur TiddlySpot se chargeait correctement dans Chrome, vous devriez à nouveau pouvoir y accéder, le modifier et l'enregistrer avec TiddlyFox
Lorsque vous aurez réussi à déposer une première fois votre document local, les modifications et enregistrements suivants de la version en ligne hébergée sur Tiddlyspot devraient fonctionner avec le navigateur récent de votre choix.
N'oubliez pas de remplir le nom du wiki TiddlySpot et son mot de passe dans l'onglet Sauvegarde de votre panneau de contrôle pour chaque nouveau navigateur que vous souhaitez utiliser pour enregistrer vos modifications.
Créez un nouveau wiki, ou ouvrez un dossier hébergeant un wiki nodejs existant
Les modifications sont enregistrées automatiquement, et vous pouvez éventuellement configurer TidGi pour les synchroniser sur github toutes les 30 minutes
AndroidChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaSafariEnregistrer les modificationsWindows
TiddlyWiki peut enregistrer les modifications d'un wiki mono-fichier directement dans un dépôt GitHub.
L'enregistrement vers un service Git se configure dans le Panneau de contrôle, dans l'onglet Enregistrement. Selon le service cible souhaité, choisissez parmi les onglets Enregistreur GitHub, Enregistreur GitLab ou Enregistreur ~Gitea. Les paramètres suivants sont disponibles :
Nom d'utilisateur - (obligatoire) le nom d'utilisateur du compte à utiliser sur le service Git choisi
Mot de passe - (obligatoire) le mot de passe, le jeton OAUTH ou le personal access token (jeton d'accès personnel) associé. Notez que GitHub a déprécié l'authentification par mot de passe, les methodes d'authentification permises sont décrites dans la documentation de l'API.
Dépôt cible - (obligatoire) le nom du dépôt à utiliser. Il faut préciser le nom de l'utilisateur suivi du nom du dépôt, séparés par un /, par exemple Jermolene/TiddlyWiki5
Branche - (optionnel) le nom de la branche dans laquelle enregistrer le wiki. Valeur par défaut : main dans GitHub et master dans GitLab.
Chemin - (optionnel) le chemin pour atteindre le fichier cible. Valeur par défaut : /
Nom du fichier cible - (obligatoire) le nom de fichier de votre wiki
Notes :
Le mot de passe ou le jeton d'accès sont enregistrés dans le stockage local du navigateur de façon persistante. Assurez-vous de nettoyer le mot de passe si vous utilisez une machine publique ou partagée. L'utilisation d'un jeton d'accès personnel pour l'authentification offre une couche de sécurité supplémentaire : si le jeton est compromis, il peut être révoqué sans réinitialiser le mot de passe principal du compte.
AndroidChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaSafariEnregistrer les modificationsWindows
Un serveur Ruby minimal qui utilise Webrick. Il présente les fichiers du dossier courant et permet l'enregistrement.
Lancez le script, puis naviguez vers l'adresse http://localhost:8000 pour voir le contenu du dossier choisi, et cliquez sur le fichier HTML de votre wiki.
Server for TiddlyWiki5, as well as other files (e.g. images used in TW5 [img[images/*.png]]);
Easy to save wiki via browsers;
Backup wiki in compress format (.gz), to save disk space;
Auto clean backups: keep one newest per previous month, keep all backups in current month.
Upload files/images to server via pressing button or drag-and-drop, for use in tiddlywiki as external links.
Offer binary executable for Linux, macos, Android and windows.
Download executable binary at the github.com tw5-server.
Usage
tw5server -a:192.168.0.10 -p:8000 -d:./ -b:backup
-h usage help
-a address, defautl localhost
-p port, default 8000
-d directory to servering, default `current dir`
-b backup directory name, default `backup`
-l log saving messages to stdout
Backups auto-clean strategy:
Keep all backups in current month, keep only the newest one for previous months.
In Unix/Linux, maybe first chmod +x tw5server), then run it.
For Android version, run it in Termux, or some other terminals.
Then go to http://localhost:8000 (or other address:port specified in command) in your web browser, and click on your wiki html file.
AndroidChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaPHPSafariEnregistrer les modificationsWindows
Lorsqu'il est hébergé sur un serveur WebDAV, un fichier TiddlyWiki créé après 2016 enregistre automatiquement ses modifications en HTTP. Si vous avez créé votre wiki avant le 16 février 2016 vous devez le mettre à jour pour activer WebDAV.
Serveurs légers et multi-plateformes
Solutions légères, portables et faciles d'emploi :
Enregistrez votre fichier TiddlyWiki avec une extension .aspx
Copiez-le vers une bibliothèque synchronisée SharePoint/OneDrive for Business
Tant que WebDAV est actif, renommer un wiki mono-fichier de .html à .aspx fonctionne lorsqu'il est stocké dans l'un de ces dossiers
Ça pourrait aussi fonctionner avec un Mac.
OSX
WebDavNav Server sur l'App store du Mac.
Android
RCX est un gestionnaire de fichiers open source pour Android basé sur rclone. Il est disponible aussi bien sur F-Droid que Google Play. Grâce à son serveur WebDAV intégré, il permet d'éditer les wikis que vous gardez dans la poche, et de les partager sur le réseau local.
Serveurs
De nombreux serveurs NAS ou Subversion disposent de WebDAV nativement. Le paramétrage de votre propre serveur imposera toutefois quelques efforts :
Hébergement gratuit
Plusieurs hébergeurs WebDAV testés (box.com, swissdisk.com) ne permettent pas l'accès aux fichiers HTML dans un navigateur, ils ne peuvent donc pas être utilisés pour TiddlyWiki. Néanmoins, le serveur multimédia GMX (www.gmx.net) a été déclaré compatible WebDav avec un compte gratuit.
Koofr
Koofr est un service cloud qui met en avant le respect de la vie privée. Pour utiliser leur service WebDav, créez un compte sur koofr.eu, puis ouvrez les preferences sur leur appli web, puis password dans le menu à gauche. Descendez jusqu'à la rubrique App Passwords. Choisissez un nom comme tiddlywiki et générez un mot de passe. Contrairement à leurs recommandations, gardez en sécurité une copie du mot de passe. Téléversez votre fichier dans un dossier sur leur site, si possible sans espace dans le chemin d'accès. Ensuite, dans le navigateur saisissez l'adresse du fichier, qui ressemblera à :
https://app.koofr.net/dav/Koofr/monfichier.html
A ce moment-là, une demande d'authentification apparaîtra. Utilisez votre adresse mail de connexion et le mot de passe que vous venez de générer.
Vous devriez être en mesure de charger le wiki et d'enregistrer les modifications dedans.
Hébergement payant
pCloud
pCloud est un service cloud qui dispose de serveurs en Europe et aux États-Unis. Lors de l'inscription, vous devez choisir l'emplacement qui vous convient. Ensuite, avec votre navigateur, connectez-vous au service. Utilisez l'interface pour téléversez le fichier auquel vous voulez accéder. Il sera accessible soit sur :
https://webdav.pcloud.com
si vous avez choisi des serveurs aux États-Unis, ou sur :
https://ewebdav.pcloud.com
pour des serveurs en Europe.
Un page de navigation dans les fichiers devrait s'afficher. Sélectionnez votre wiki et ouvrez-le dans le navigateur. Vous devriez pouvoir le modifier et enregistrer les modifications.
ChromeEdgeFirefoxInternet ExplorerLinuxMacOperaSafariEnregistrer les modificationsWindows
Polly est un script Windows écrit en PowerShell utilisé pour restaurer le chemin de fichiers TiddlyWiki sélectionnés, depuis le dossier des téléchargements vers leur emplacement d'origine.
Concrètement, ça devient une nouvelle façon d'enregistrer vos fichiers, mais avec des fonctionnalités supplémentaires :
Pas d'exécutable binaire
Script lisible par un humain
Pas de plugin particulier dans votre fichier TiddlyWiki
Pas besoin d'un navigateur en particulier
Pas besoin d'extension pour le navigateur
Pas besoin de faire tourner nodejs en tâche de fond
Taille totale du script décompressé : environ 100 ko
Sauvegarde vers des dossiers paramétrables, en tant que fichiers standards ou archives ZIP
Capacité de « cloner » des copies supplémentaires vers des dossiers cibles (p.ex. un dossier Dropbox)
Fonctionne partout où PowerShell est disponible, en particulier Windows, Linux et Mac.
Cette manière d'enregistrer les modifications est assez pénible, car elle requiert une intervention manuelle à chaque enregistrement. Elle a l'avantage de fonctionner avec pratiquement tous les navigateurs tournant sur les ordinateurs de bureaux, et de nombreux navigateurs tournant sur appareils mobiles.
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
Localisez le fichier que vous venez de télécharger
Vous pouvez le renommer, mais assurez-vous de conserver l'extension .html ou .htm
Ouvrez le fichier dans votre navigateur
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
Votre navigateur téléchargera alors un nouvel exemplaire du wiki, avec vos modifications à l'intérieur
Localisez ce nouveau fichier et ouvrez-le dans votre navigateur
Vérifiez que vos modifications ont correctement été enregistrées
Truc: la plupart des navigateurs peuvent être configurés pour proposer un chemin d'enregistrement à chaque téléchargement. Cela vous permet de sélectionner la version précédente du fichier et ainsi de la remplacer.
Assurez-vous d'avoir une version de Firefox antérieure à 57. TiddlyFox ne fonctionne plus sur les versions 57 et ultérieures. Pour Firefox 57 et au-delà, pensez plutôt à utiliser :
Si vous utilisez TiddlyFox v1.x.x, cliquez OK en réponse à la demande de TiddlyFox d'activer l'enregistrement pour ce fichier
Si vous utilisez TiddlyFox v2.x.x cliquez sur l’icône de chat sur un globe bleu pour activer l'enregistrement. Il n'y a pas de demande en v2.0.1.
Pour TiddlyFox v2.0.1, vous ne pouvez pas utiliser le mode Navigation Privée, ni activer l'option « Ne jamais conserver l'historique ».
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
(pour enregistrer le lien, assurez-vous d'avoir installé l'extension "save-link-menus", appuyez quelques secondes sur le lien, puis choisissez "Save link")
Une fois le fichier téléchargé, cliquez dessus depuis la zone de notification ou l'application de gestion des téléchargements
Choisissez d'ouvrir le fichier avec Firefox (et non l'application par défaut proposée par Android)
Cliquez OK en réponse à la demande de TiddlyFox qui vous demande s'il faut activer l'enregistrement pour ce fichier
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
Localisez le fichier que vous venez de télécharger
Vous pouvez le renommer, mais assurez-vous de conserver l'extension .html ou .htm
Ouvrez le fichier dans Internet Explorer
Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale. Internet Explorer vous demandera votre assentiment pour enregistrer le fichier localement en vous présentant un dialogue Enregistrer sous....
Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement sauvegardées.
TW Receiver est un plugin TiddlyWiki et un script PHP utilisés pour enregistrer sur un serveur PHP.
Parmi ses fonctionnalités, on trouve la sauvegarde automatisée, la protection d'écriture sur instance figée, l'authentification par challenge de hachage (sécurité améliorée), et la signature d'intégrité des données (sécurité améliorée).
Visitez TW-Receiver pour accéder à plus d'informations, au plugin et à son code.
The SavingMechanism is the mechanism by which TiddlyWiki generates a new HTML file and stores it. It is different from the sync mechanism, which is concerned with synchronising changes to individual tiddlers back to a server (see https://tiddlywiki.com/dev/#SyncAdaptorModules for more details).
The following steps are involved:
The saver mechanism uses the filter defined in $:/config/SaverFilter to specify which modified tiddlers trigger the dirty state for the wiki. (The dirty state is reflected in the red colouring of the "save changes" button in the sidebar).
The template includes a variable assignment that specifies a filter to select the tiddlers that should be included in the saved file. It then transcludes the main page template $:/core/templates/tiddlywiki5.html
The template includes a reference to $(publishFilter)$ that allows the filter to be customised via a global variable
The tm-save-wiki handler renders the template to generate the HTML file
The message handler chooses the highest priority "saver" module that can handle saving the file
Vous pourriez vous demander si l'architecture de TiddlyWiki en tant que SinglePageApplication serait adaptée pour de gros volume de d'information. En réalité, les utilisateurs de TiddlyWiki travaillent souvent avec des fichiers de 20 or 30 mégaoctets sans problème - et des expérience traitant des gigaoctets ont aussi été couronnées de succès.
The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.
All the scripts expect to be run from the root folder of the repository.
This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.
To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.
Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).
test: build and run tests
This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.
lazy: serves tw5.com with lazily loaded images
./bin/lazy.sh <username> [<password>]
Or:
./bin/lazy.cmd <username> [<password>]
This script serves the tw5.com-server edition content with LazyLoading applied to images.
The scrollable widget wraps its content in a scrollable frame. The user can scroll the contents with the mouse or with touch gestures. Code can use the WidgetMessage: tm-scroll to programmatically scroll specific DOM nodes into view.
Content and Attributes
The content of the <$scrollable> widget is displayed within a pair of wrapper DIVs. If the inner DIV is larger then it scrolls within the outer one. CSS is used to specify the size of the outer wrapper.
Attribute
Description
class
The CSS class(es) to be applied to the outer DIV
fallthrough
See below
Note
If a scrollable widget can't handle the tm-scroll message because the inner DIV fits within the outer DIV, then by default the message falls through to the parent widget. Setting the fallthrough attribute to no prevents this behaviour.
Examples
This example requires the following CSS definitions from $:/_tw5.com-styles:
Depuis : 5.1.18 The search filter operator was significantly enhanced in 5.1.18. Earlier versions do not support the extended syntax and therefore do not permit searching multiple fields, or the literal or casesensitive options.
The search operator uses an extended syntax that permits multiple fields and flags to be passed:
[search:<field list>:<flag list>[<operand>]]
field list: a comma delimited list of field names to restrict the search
defaults to tags, text and title if blank
an asterisk * instead of the field list causes the search to be performed across all fields available on each tiddler
preceding the list with a minus sign - reverses the order so that the search is performed on all fields except the listed fields
flag list: a comma delimited list of flags (defaults to words if blank)
operand: filter operand
This example searches the fields title and caption for a case-sensitive match for the literal string :
Search mode - the first to be set of the following flags determines the type of search that is performed:
literal: considers the search string to be a literal string, and requires an exact match
whitespace: considers the search string to be a literal string, but will consider all runs of whitespace to be equivalent to a single space. Thus A B matches A B
regexp: treats the search string as a regular expression. Note that the regexp option obviates the need for the older regexp operator.
words: (the default) treats the search string as a list of tokens separated by whitespace, and matches if all of the tokens appear in the string (regardless of ordering and whether there is other text in between)
some: Depuis : 5.2.2 treats the search string as a list of tokens separated by whitespace, and matches if at least one of the tokens appear in the string
casesensitive: if present, this flag forces a case-sensitive match, where upper and lower case letters are considered different. By default, upper and lower case letters are considered identical for matching purposes.
anchored: Depuis : 5.1.20 anchors the search to the start of the string (applies to whitespace, literal and words modes)
You can use the search-replace Operator in combination with the sortsub Operator to ignore stop words like "A" and "The" at the beginning of titles when sorting. (Note for example that "A Tale of Two Cities" sorts under "T" rather than "A")
Saisir du texte dans la case recherche du menu latéral listera une liste de tous les tiddlers contenant ce texte.
(Notez que les onglets du menu latéral seront masqués par les résultats de la recherche jusqu'à ce que vous cliquiez sur le 'x' à droite de la case de recherche pour les faire disparaitre)
Recherche avancée
Cliquer sur l'icone loupe à droit de la case de recherche ouvrira $:/AdvancedSearch, un tiddler contenant 4 onglets :
L'onglet standard est un autre présentation de la case recherche du menu classique
L'onglet système étend la recherche aux tiddlers système
L'onglet shadows étend la recherche aux tiddlers shadows
L'onglet filtre n'est pas une case de recherche, en soi, mais juste un moyen d'avoir une liste de tous les tiddlers selon les critères définis par le filtre, par exemple, "Toutes les étiquettes hormis les tags système"
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
La plupart des opérateurs forment leurs résultats à partir de leurs entrées. Par exemple, la plupart produisent un sous-ensemble de leur entrée, et se faisant, méritent vraiment leur nom de "filtres",car ils réduisent la taille du résultat généré par la séquence. Ces opérateurs sont nommés modifieurs de sélection.
Quelques opérateurs ignorent leurs entrées et génèrent un résultat indépendant. Ils sont appelés constructeurs de sélection : Ils construisent une sélection entièrement nouvelle.
Un bon exemple de constructeur est l'opérateur title. Le résultat de [title[A]title[B]] est juste B. Mais l'ajout de l'opérateur modifieur field, [title[A]field:title[B] ne produit plus rien du tout.
The select widget displays a popup menu based on a HTML select element. The popup (or dropdown) contains a list of items defined by <option> and <optgroup> elements.
Every time the user selects a new value in the menu, the selected value is written to the text of a specified tiddler field or index and any ActionWidgets within the actions attribute are triggered. Conversely, if the tiddler value is changed independently the select widget is automatically updated to reflect the new value.
In multiple selection mode, the list of selected values is bound to the specified tiddler field or index. Browsers generally use the ctrl or cmd keys for multiple selection.
For example, this select widget displays a list of the tags in this wiki:
See the text change as you switch entries in the select widget. Try changing the value of the state tiddler and see the select widget change. Notice how the select widget only displays an entry if there is a precise match with the tiddler text.
Content and Attributes
The content of the <$select> widget should be one or more HTML <option> or <optiongroup> elements that provide the available values.
Attribute
Description
tiddler
The title of the tiddler containing the value to be displayed/modified by the select widget (defaults to the current tiddler)
field
The field name for the value in the current tiddler (defaults to "text")
index
The index of a property in a DataTiddler (takes precedence over the field attribute)
class
CSS classes to be assigned to the HTML select element
tooltip
Optional tooltip
default
Default value to be used if the tiddler, field or index specifies a missing value
multiple
If present, switches to multiple selection mode
size
The number of rows to display in multiple selection mode
actions
A string containing ActionWidgets to be triggered when the key combination is detected
focus
Depuis : 5.2.4 Optional. Set to "yes" to automatically focus the HTML select element after creation
tabindex
Depuis : 5.3.1 Optional. Sets the tabindex attribute of the HTML select element to the given value
Examples
Simple Lists
This example sets the title of the current wiki $:/SiteTitle to one of a list of book titles:
<$select tiddler='$:/SiteTitle' tooltip='Choose a new site title'>
<option>A Tale of Two Cities</option>
<option>A New Kind of Science</option>
<option>The Dice Man</option>
</$select>
Affichera ceci :
Simple List with Placeholder Value
To display a default value that is also disabled, effectively functioning as a placeholder, the following form can be used. Note that the targeted field must be empty, or not exist, for the placeholder to show in the widget:
<$select tiddler='New Tiddler' field='text' default='Choose a new text'>
<option disabled>Choose a new text</option>
<option>A Tale of Two Cities</option>
<option>A New Kind of Science</option>
<option>The Dice Man</option>
</$select>
Affichera ceci :
Value lists
In this example the value attribute has been used to specify the text that should be used as the value of the entry instead of the display text.
<$select tiddler='$:/SiteTitle'>
<option value='cities'>A Tale of Two Cities</option>
<option value='science'>A New Kind of Science</option>
<option value='dice'>The Dice Man</option>
</$select>
Affichera ceci :
Option Groups
Entries in the list can be grouped together with the <optgroup> element
<$select tiddler='$:/SiteTitle'>
<optgroup label='Fiction'>
<option value='cities'>A Tale of Two Cities</option>
<option value='dice'>The Dice Man</option>
</optgroup>
<optgroup label='Non-fiction'>
<option value='science'>A New Kind of Science</option>
<option value='recursive'>The Recursive Universe</option>
</optgroup>
</$select>
Affichera ceci :
Generated Lists
The ListWidget can be used to generate the options for a select widget. For example, here we combine a select widget listing all the tiddlers tagged TableOfContents with a transclusion to display the text of the selected one.
This operator does not change anything except the first letter of each title, so [[aBcD eFgH]] would become [[ABcD eFgH]]. If you want [[Abcd efgh]], then use a filter like [lowercase[]sentencecase[]].
port - numéro de port sur lequel servir le contenu ; une valeur non-numérique sera interprétée comme un nom de variable d'environnement du système dont la valeur est le numéro de port (défaut : "8080")
tiddler-racine - le titre du tiddler à afficher à la racine de l'URL (défaut : "$:/core/save/all")
type-du-rendu - le type avec lequel le contenu du tiddler racine doit être rendu (text/plain par défaut)
type-du-service - le type avec lequel le contenu du tiddler racine doit être servi (text/html par défaut)
nom-d-utilisateur - le nom d'utilisateur qui servira par défaut à signer les modifications
mot-de-passe - mot de passe optionnel permettant une authentification basique
machine - nom de machine optionnel d'où le contenu doit être servi ("127.0.0.1" par défaut, autrement dit "localhost")
préfixe-des-chemins - préfixe optionnel pour les chemins de fichiers
niveau-débogage - optional debug level; set to "debug" to view request details (defaults to "none")
Si le mot de passe est spécifié en argument, le navigateur demandera à l'utilisateur d'entrer le nom d'utilisateur et le mot de passe. On notera que le mot de passe est transmis en clair, et que cette implémentation ne convient donc pas pour un usage général.
Le nom d'utilisateur et le mot de passe peuvent être spécifiés sous forme de chaînes vides si vous avez besoin d'indiquer le nom de machine ou le préfixe des chemins sans pour autant demander un mot de passe :
Si vous voulez faire tourner plusieurs serveurs TiddlyWiki en même temps sur la même machine, vous devrez leur assigner chacun un port différent. Il peut être utile d'utiliser une variable d'environnement pour passer le numéro de port au process Node.js. L'exemple suivant utilise une variable d'environnement appelée "MY_PORT_NUMBER" :
AndroidEnregistrer les modificationsTiddlyWiki sur Node.js
Termux est une application Android open source qui fournit un environnement Unix suffisant pour installer Node.js et des modules npm sur Android. Les utilisateurs peuvent installer et exécuter TiddlyWiki sur Node.js grâce à Termux.
Si vous avez besoin de créer/partager TiddlyWiki sur Node.js à partir de la mémoire interne, vous devez accorder à Termux les autorisations d'accès au stockage en exécutant la commande suivante dans Termux :
termux-setup-storage
Vous pouvez maintenant créer et partager TiddlyWiki sur Node.js à partir de la mémoire interne. Dans les exemples ci-dessous, l'utilisateur crée un nouveau wiki nommé monnouveauwiki dans son dossier interne :
cd storage/shared
tiddlywiki monnouveauwiki --init server
tiddlywiki monnouveauwiki --listen
A partir de là, tant que Termux fonctionne vous pouvez accéder à votre wiki à votre convenance depuis votre navigateur favori en le faisant pointer vers l'adresse et le port attendus.
Pour plus d'informations et d'astuces sur Termux, consultez le wiki Termux
Dans Termux, vous pouvez aussi installer git, emacs ou vi, afin d'éditer et maintenir les fichiers des tiddlers individuels. Vous aurez probablement besoin d'un meilleur clavier pour votre appareil, comme l'application Hacker's Keyboard ou un périphérique externe Bluetooth.
Notez que cette commande est expérimentale et peut changer ou être remplacée avant d'être finalisée
Initialise le champ spécifié d'un groupe de tiddlers avec le résultat de la wikification d'un tiddler template, la variable currentTiddler prenant tour à tour la valeur de chaque tiddler.
list: [[Discover TiddlyWiki]] [[Some of the things you can do with TiddlyWiki]] [[Ten reasons to switch to TiddlyWiki]] Examples [[History of TiddlyWiki]] [[What happened to the original TiddlyWiki?]]
modified: 20220217174842374
tags: TableOfContents
text: ''N'avez-vous jamais eu la sensation que votre tête était trop petite pour contenir tout ce que vous avez besoin de mémoriser<<?>>''
Bienvenue sur TiddlyWiki, un carnet de notes web [[non-linéaire|Philosophy of Tiddlers]] pour [[saisir|Creating and editing tiddlers]], [[organiser|Structuring TiddlyWiki]] et [[partager|Sharing your tiddlers with others]] des informations simples ou complexes.
Utilisez-le pour gérer votre [[liste de tâches|TaskManagementExample]], faire le plan d'un [[essai ou d'une nouvelle|"TiddlyWiki for Scholars" by Alberto Molina]], ou pour organiser votre mariage. Enregistrez tout ce qui vous traverse l'esprit, ou construisez un site web flexible et réactif.
<div style="font-size:0.7em;text-align:center;margin-top:2em;margin-bottom:2em;">
<<list-thumbnails filter:"[tag[HelloThumbnail]]" width:"168" height:"95">>
</div>
Contrairement aux services en ligne classiques, TiddlyWiki vous permet de choisir où conserver vos informations, et garantit que, dans les décennies à venir, vous pourrez toujours utiliser les notes que vous prenez aujourd'hui.
<div style="font-size:0.7em;text-align:center;margin:3em auto;">
<a href="https://talk.tiddlywiki.org/" class="tc-btn-big-green" style="border-radius:4px;background-color:#FF8C19;" target="_blank" rel="noopener noreferrer">
{{$:/core/images/help}} ~TalkTW
</a>
<a href="https://www.youtube.com/c/JeremyRuston" class="tc-btn-big-green" style="border-radius:4px;background-color:#e52d27;" target="_blank" rel="noopener noreferrer">
{{$:/core/images/video}} ~YouTube
</a>
<a href="https://twitter.com/TiddlyWiki" class="tc-btn-big-green" style="border-radius:4px;background-color:#5E9FCA;" target="_blank" rel="noopener noreferrer">
{{$:/core/images/twitter}} Twitter
</a>
<a href="https://github.com/Jermolene/TiddlyWiki5" class="tc-btn-big-green" style="border-radius:4px;background-color:#444;" target="_blank" rel="noopener noreferrer">
{{$:/core/images/github}} ~GitHub
</a>
<a href="https://gitter.im/TiddlyWiki/public" class="tc-btn-big-green" style="border-radius:4px;background-color:#753a88;background-image:linear-gradient(to left,#cc2b5e,#753a88);" target="_blank" rel="noopener noreferrer">
{{$:/core/images/gitter}} Gitter
</a>
</div>
Les « favicons » sont de petites icones que la plupart des navigateurs web affichent pour aider les utilisateurs à identifier les sites web.
favicons dans le Navigateur
Lorsque TiddlyWiki démarre dans le navigateur, il cherche un tiddler nommé $:/favicon.ico et l'utilise dynamiquement comme favicon de la page. Si vous modifiez l'image, le favicon change instantanément pour en tenir compte.
favicons sur le Serveur
Sur le serveur, la commande server servira le tiddler $:/favicon.ico sur le chemin /favicon.ico.
Ouvrez le $:/ControlPanel et sélectionnez réglage thème dans l'onglet Apparence
Choisissez votre image à partir de la liste déroulante "Page background image"
Réglez "Fixation de l'image de fond de page" à "Fixée à la fenêtre" pour un fond d'écran figé avec le contenu se déroulant au dessus, ou "Défile avec les tiddlers" pour le faire se déplacer (notez que les iPhone/iPad n'acceptent pas le réglage fixé pour des raisons de performance)
Réglez "Taille de l'image de fond de page" comme suit :
Auto permet à l'image de dépasser le cadre du fond de page
Élargie étend l'image jusqu'à ce que sa taille couvre complètement la page. Une partie de l'image peut être tronquée
Contenue ajuste l'image de façon à ce qu'elle s'inscrive complètement dans la page
Notez que la palette DarkPhotos est proposée pour rendre le menu latéral plus lisible avec les images de fond sombres.
Le widget set variable affecte une valeur à une variable spécifiée. La nouvelle valeur est alors disponible par le contenu dans le cadre défini du widget.
Contenu et Attributs
Le contenu du widget <$set> forme le cadre de la valeur affectée à la variable.
Attribut
Description
name
Le nom de la variable à affecter (par défaut du "Tiddlercourant")
value
La valeur à affecter à la variable si le filtre est manquant ou non vide
filter
Un filtre optionnel à évaluer et à affecter à la variable (voir ci-dessous)
emptyValue
La valeur à affecter à la variable si le filtre évalue une liste vide (voir ci-dessous)
Affectation simple d'une variable
L'utilisation la plus simple du widget set variable affecte une chaine à une variable. L'exemple suivant affecte une chaine littérale
Cette forme du widget set variable choisit une des deux valeurs spécifiées selon que le résultat du filtre soit une liste vide ou pas. Voici un exemple affectant une variable selon que le tiddler courant se nomme "monTitreMagique" ou pas :
<$set name="maVariable" filter="[all[current]field:title[monTitreMagique]]" value="C'est magique" emptyValue="Ce n'est pas magique">
<$text text=<<maVariable>>/>
</$set>
Affectation d'une liste filtrée de variable
Cette forme du widget set variable évalue le filtre et affecte le résultat à la variable sous forme de liste séparée par des espaces (utilisation des double crochets pour les titres contenant des espaces).
Hashes are a way of turning strings of arbitrary length into obfuscated strings of fixed length. They are often used in situations where items need to be stored by name but it is inconvenient to allow arbitrary length strings.
See Wikipedia for details of the sha256 operation.
Each input title is processed in turn. If it denotes a shadow tiddler, the title of its plugin tiddler is dominantly appended to the output. Non-shadow tiddlers contribute nothing to the output.
Les tiddlers shadow sont des tiddlers chargés à partir d'un Plugins. Contrairement aux tiddlers ordinaires, ils n'apparaissent pas dans de multiple listes.
Les tiddlers shadow peuvent être remplacés par un tiddler ordinaire de même nom. Si ce tiddler est supprimé, le tiddler shadow est alors automatiquement restauré.
Vous pouvez travailler sur un fichier TiddlyWiki dans Dropbox et publier un lien que chacun pourra visualiser en lecture seule.
Mettez votre fichier TiddlyWiki dans un répertoire Dropbox
Choisir l'option "Partager lien" de Dropbox pour avoir un lien d'accès publique au fichier
Dans l'interface web de Dropbox, c'est possible en cliquant sur l'icone du lien qui apparait au survol du fichier. Dropbox ajoute aussi un élément "Lien Partagé" au menu contextuel du Finder sur OS X et de l'Explorateur Windows
Vous pouvez exporter des tiddlers () dans plusieurs formats de fichiers tels que texte (.TID), HTML statique, JSON et CSV (valeurs séparées par des virgules, compatibles avec les tableurs)
Vous pouvez aussi partager des tiddlers simplement en rendant votre TiddlyWiki accessible aux autres, par exemple en le publiant en ligne, ce qui leur permettra d'importer des tiddlers qu'il contient
Il y a un plugin de partage expérimental que vous pouvez utiliser pour partager des tiddlers grâce à une URL spécialement conçue à cet effet.
Sometimes you want to protect individual tiddlers from accidental changes, either from yourself or guests to your TiddlyWiki file. Here's a couple simple approaches. Note that these do not provide hardened protection against a wilful attack.
Using a stylesheet to lock tiddlers by tag name
Create a tiddler with the following contents and tag it as $:/tags/Stylesheet :
[data-tags*="Locked"] button[title="Edit this tiddler"] {display: none;}
If your TW language isn't English, then you'll need to change the text in 'title="...."' to whatever the text is when you hover over the edit button.
Now any tiddler you tag as "Locked" will have the edit button hidden. To get it back you will need to open the stylesheet tiddler and change "none" to "inline".
Using transclusion to hide your tiddler in a system tiddler
Open your tiddler for editing.
Select the title and copy.
Select all the tiddler text.
Click on the excise tool.
In the title box, type $:/ and then paste the original title.
Use the defaults to excise the text into a new tiddler and replace it with a transclusion
Now you can view the contents of your original tiddler, but to edit them you will have to find the the tiddler with the $:/ prefix.
J'ai voulu évaluer la possibilité de créer un certain type de jeu en utilisant seulement le noyau de tiddlywiki sans plugins ou code javascript. J'ai réalisé un jeu de fiction interactif de type zork réduit à l'essentiel. C'est le jeu le plus simple que je puisse faire à ce jour, mais je pourrai faire quelques ajouts à l'avenir. il utiliser la préversion 5.1.5 car le widget action-setfield épargne un gros travail d'élaboration de macros.
Le but était de n'utiliser que les fonctions du noyau de tiddlywiki, aussi il n'y a ni plugins, ni javascript.
A single file application is a web application where all of the assets are delivered in a single static file. This means that it can be downloaded and used offline without losing functionality. It can also be hosted on almost any type of web server.
TiddlyWiki is an unusual single file application because it stores its data within the same file, and is capable of saving changes to itself.
Every single file application must also by definition be a SinglePageApplication, but the converse is not true.
As defined by Wikipedia, a SinglePageApplication is a web application that presents itself as a single HTML document that dynamically loads additional content as the user browses the site. Frequently, single page applications are carefully designed to hide their nature, appearing and functioning as an ordinary static website by respecting the address bar and the back/forward navigation controls.
The content of the $slot widget is used as a fallback for the slot content if the corresponding $fill widget is not found.
Attribute
Description
$name
The name of the slot being defined
$depth
Optional number indicating how deep the $slot widget is compared to the matching $fill widget as measured by the number of nested transclude widgets (defaults to 1). Transclude widgets whose $fillignore attribute is set to yes are ignored, and do not affect the depth count
Examples
Quoted content
When content contains quotes, passing it through attributes and parameters can be challenging. However, passing the content using the $fill widget content eliminates the need to wrap it in quotes, making the process easier.
If a variable named bold_slot contains the following $slot definition:
<b>
<$slot $name="body"/>
</b>
then the slot can be filled using this variable transclusion:
<$transclude $variable=bold_slot>
<$fill $name=body>
"""
some text
using [[Hard Linebreaks in WikiText]]
syntax
"""
</$fill>
</$transclude>
The slot1 slot is filled at both depths with a simple string (outer1 and outer2). For slot2, the outer instance is a simple string but the inner instance recursively transcludes the same table_slot variable again. The recursion ends at the third transclusion call since both "inner" slots are filled with simple strings.
Garder trace de vos tâches et rendez-vous, et organisez-les à l'aide de tags multiples (voir notre exemple de gestion de tâches) ;
Inventorier tout ce qui vous passe par la tête : vos recettes, votre bibliothèque personnelle, vos contacts, votre collection de morceaux de musique, etc. ;
Partager les informations contenues dans votre TiddlyWiki avec d'autres, sous forme de fichier en ligne, de pièce jointe dans un email, d'un fichier tiddler, ou d'un lien vers un tiddler en ligne précis (essayez de cliquer sur un lien de tiddler et de le transporter depuis un TiddlyWiki vers un autre, pour voir) ;
Faire une esquisse de dessin (éditez Motovun Jack.jpg et commencez à dessiner sur l'image, pour visualiser) ;
Créer un assistant modal (on parle aussi de lightbox) — voir Exemple d'assistant ;
Créer une présentation de type « transparents » ;
Créer une base de connaissance complète en local ou en ligne, à partir d'un fichier TiddlyWiki central pointant vers d'autres fichiers TiddlyWiki (un exemple est visible à l'adresse http://recursos.giffmex.org) ;
sort the input titles by the result of evaluating this filter run for each item
input
all titles from previous filter runs
suffix
the :sort filter run prefix uses a rich suffix, see below for details
output
the sorted result of previous filter runs
Each input title from previous runs is passed to this run in turn. The filter run transforms the input titles into the form needed for sorting. For example, the filter run [length[]] transforms each input title in to the number representing its length, and thus sorts the input titles according to their length.
Note that within the filter run, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits filter runs like :sort:number[{!!value}divide{!!cost}] to be used for computation. The value of currentTiddler outside the run is available in the variable "..currentTiddler".
The :sort filter run prefix uses an extended syntax that allows for multiple suffixes, some of which are required:
:sort:<type>:<flaglist>[...filter run...]
type: Required. Determines how the items are compared and can be any of: string, alphanumeric, number, integer, version or date.
flaglist: comma separated list of the following flags:
casesensitive or caseinsensitive (required for types string and alphanumeric).
reverse to invert the order of the filter run (optional).
Note that filter runs used with the :sort prefix should return the same number of items that they are passed. Any missing entries will be treated as zero or the empty string. In particular, when retrieving the value of a field with the get Operator it is helpful to guard against a missing field value using the else Operator. For example [get[myfield]else[default-value]....
Each item in the list of input titles is passed to the subfilter in turn. The subfilter transforms the input titles into the form needed for sorting. For example, the subfilter [length[]] transforms each input title in the number representing its length, and thus sorts the input titles according to their length.
Note that within the subfilter, the "currentTiddler" variable is set to the title of the tiddler being processed. This permits subfilters like [{!!value}divide{!!cost}] to be used for computation.
The value of currentTiddler outside the subfilter is available in the variable "..currentTiddler". Depuis : 5.2.0
The suffix T determines how the items are compared and can be:
"string" (the default)
"number" - invalid numbers are interpreted as zero
"integer" - invalid integers are interpreted as zero
"date" - invalid dates are interpreted as 1st January 1970
"version" - invalid versions are interpreted as "v0.0.0"
"alphanumeric" - treat items as alphanumerics Depuis : 5.2.0
Note that subfilters should return the same number of items that they are passed. Any missing entries will be treated as zero or the empty string. In particular, when retrieving the value of a field with the get Operator it is helpful to guard against a missing field value using the else Operator. For example [get[myfield]else[default-value]....
You can use the search-replace Operator in combination with the sortsub Operator to ignore stop words like "A" and "The" at the beginning of titles when sorting. (Note for example that "A Tale of Two Cities" sorts under "T" rather than "A")
Note that in some circumstances the split operator will include blank items in the list of results. For example,
[[the band thethe are the best the]split[the]]
The following results are returned:
["", " band ", "", " are ", " best ", ""]
Where it might be expected that the results would be:
[" band ", " are ", " best "]
The blank items mark the boundaries between matches. If they are not required they can be removed with the blank category of the is Operator: [[the band thethe are the best the]split[the]!is[blank]].
The reason that the blank items can be useful is that they allow search and replace operations to be constructed from a combination of the split Operator or splitregexp Operator and the join Operator. For example:
[[the band thethe are the best the]split[the]join[every]]
Note that in some circumstances the splitregexp operator will include blank items in the list of results. For example,
[[the band thethe are the best the]splitregexp[the]]
The following results are returned:
["", " band ", "", " are ", " best ", ""]
Where it might be expected that the results would be:
[" band ", " are ", " best "]
The blank items mark the boundaries between matches. If they are not required they can be removed with the blank category of the is Operator: [[the band thethe are the best the]splitregexp[the]!is[blank]].
The reason that the blank items can be useful is that they allow search and replace operations to be constructed from a combination of the split Operator or splitregexp Operator and the join Operator. For example:
[[nobody, really; wants; to see -- all this \punctuation]splitregexp[,|;|-|\\]join[...]]
Syntax errors in the regular expression will cause the filter to return an error message. For example:
The Stanford Javascript Crypto Library is a project by the Stanford Computer Security Lab to build a secure, powerful, fast, small, easy-to-use, cross-browser library for cryptography in Javascript.
TiddlyWiki executes any ActionWidgets found in tiddlers with the following system tags during startup:
Executed during initial startup:
$:/tags/StartupAction (executed on all platforms)
$:/tags/StartupAction/Browser (only executed when running in the browser)
$:/tags/StartupAction/Node (only executed when running under Node.js)
Executed after startup rendering:
Depuis : 5.1.23$:/tags/StartupAction/PostRender (only executed when running in the browser)
Initial Startup Actions
The initial startup actions are useful for customising TiddlyWiki according to environmental factors such as the screen size. For example, the following action widgets when placed in a tiddler tagged $:/tags/StartupAction/Browser will cause the sidebar to be hidden by default when the screen width is less than 1000 pixels:
Note that global macros are not available within initial startup action tiddlers by default. If you need to access them then you'll need to explicitly include them with an Pragma: \import at the top of the tiddler:
Depuis : 5.1.23 Post-render startup actions occur after the TiddlyWiki user interface has been rendered. This makes it possible to perform actions that depend on the rendered display (such as displaying modals).
In the browser, the TiddlyWiki display is produced by dynamically rendering the tiddler $:/core/ui/PageTemplate. Through various transclusions and other widgets it renders the entire user interface. The dynamic rendering is accomplished by a mechanism called "binding": any changes to the tiddlers in the store are dynamically reflected in the browser display.
The stack of templates that make up the TiddlyWiki display are complex but we'll focus on the line that displays the main story column:
Breaking down the attributes applied to the list widget:
filter: selects the list of tiddlers in the list field of the tiddler $:/StoryList. If a tiddler is added or removed from that list then it is automatically reflected in the displayed list
history: references the tiddler to be used to store the history stack (see the HistoryMechanism)
template: identifies a template tiddler to be used for rendering each tiddler in the list
editTemplate: identifies a different template tiddler to be used for rendering tiddlers that are in draft mode
storyview: specifies the story view to be used (eg classic, or zoomin)
The $:/StoryList tiddler is an example of a StateTiddler: a tiddler that is used to hold the state of the user interface. Changes to the user interface are made indirectly, by changing the underlying state tiddlers, and letting TiddlyWiki ripple the changes through the user interface.
Note how this approach makes the open tab in the sidebar very easy to implement: it is just another list widget referencing the same state tiddler, but with a different template:
Now consider the implementation of the info panel within the tiddler template. We want to be able to toggle the info panel open and closed, which means that we must track its current state in a tiddler.
However, we can't track the state in a tiddler called, say, $:/InfoPanelState because every tiddler would share the same state; changing the value of the tiddler would affect all tiddlers displayed in the story.
The solution is to dynamically generate a unique title for each state tiddler that we need. We need to ensure that the same state tiddler title is generated each time a user interface element is rendered. To do that, we append together tokens representing each of the stack of transclusions that led to the current rendering location. Then that string of symbols is hashed to a simple numeric value.
The process of generating a state tiddler title is encapsulated in the qualify macro.
The Story Tiddler Template Cascade is used to choose the template to be used for a particular tiddler. By default, the edit template is used for tiddlers in draft mode, and the view template used otherwise.
You can see the current settings for the story tiddler template cascade in $:/ControlPanel under the Info -> Advanced -> Cascades -> Story Tiddler tab.
Depuis : 5.1.23 If the suffix rawunicode is present, Unicode characters above 0x80 (such as ß, ä, ñ or 🎄) will be passed through unchanged. Without the suffix, they will be substituted with \u codes, which was the default behavior before 5.1.23.
Note
Characters outside the Basic Multilingual Plane, such as 🎄 and other emojis, will be encoded as a UTF-16 surrogate pair, i.e. with two \u sequences.
jsonstringify is considered deprecated, as it duplicates the functionality of stringify.
TiddlyWiki5 fournit plusieurs fonctionnalités qui vous aideront à structurer les informations sous forme de tiddlers, et à modéliser les relations entre eux :
Compare with the similar filter operator which runs a subfilter against each title, returning those titles that return a non-empty list (and discards the results of the subfilter)
The subfilter operator will act as a constructor whenever the filter defined by its operand is a constructor. Otherwise, it will act as a modifier.
Literal filter operands can be used, but such cases are better rewritten without using subfilter:
[subfilter[one two three]addsuffix[!]]
→ same as one two three +[addsuffix[!]]
The subfilter operator can be used to dynamically define parts of a filter run. This is useful for sharing a common pieces of a filter across multiple filters.
Variables are not the only way to define dynamic subfilters. Text references can be used to load a subfilter from a tiddler field (see also Filter Parameter):
The substitute operator replaces any placeholders in the input titles in the following order:
filter expressions
parameters to the substitute operator
variables
placeholder syntax
description
$n$
Text substitution of a parameter provided to the operator, where n is the position of the parameter starting with 1 for the first parameter. Unmatched placeholders pass through unchanged.
$(varname)$
Text substitution of a variable. Undefined variables are replaced with an empty string.
${ filter expression }$
Text substitution of the first result of evaluating a filter expression. In other words, if the filter returns multiple titles only the first one will be used.
Placeholders that contain square bracket characters are not valid filter syntax when used directly in a filter expression. However they can be provided as input to the substitute operator as text references or variables
Substituted attribute values can use two different styles of quoting:
Single backticks
attr=`value`
Triple backticks
attr=```value```
The value of the attribute will be the text denoted by the backticks with any of the placeholders for filter expressions and variables substituted with their corresponding values. Filter expression placeholders are substituted before variable placeholders, allowing for further variable substitution in their returned value.
Any other wiki syntax in that text will be left as-is.
placeholder syntax
description
$(varname)$
Text substitution of a variable. Undefined variables are replaced with an empty string.
${ filter expression }$
Text substitution with the first result of evaluating the filter expression.
Examples
Substituting a variable value into a string
<$text text=`Hello there this is the tiddler "Substituted Attribute Values"`/>
Affichera ceci :
Hello there this is the tiddler "Substituted Attribute Values"
Substituting a variable value and the result of evaluating a filter expression into a string
<$text text=`This tiddler is titled "Substituted Attribute Values" and was last modified on ${[{!!modified}format:date[DDth MMM YYYY]]}$`/>
Affichera ceci :
This tiddler is titled "Substituted Attribute Values" and was last modified on 15 juin 2023
Concatenating strings and variables to create a URL
<$let hash={{{ [<currentTiddler>encodeuricomponent[]] }}}>
<a href=`http://tiddlywiki.com/#`>this tiddler on tiddlywiki.com</a>
</$let>
The system tag$:/tags/ClassFilters/PageTemplate marks filters marks filters evaluated to dynamically add their output as CSS classes to the page template.
The system tag$:/tags/EditorTools can be used to include non-button UI elements in the edit mode tiddler toolbar. For buttons see SystemTag: $:/tags/EditToolbar.
The system tag$:/tags/KeyboardShortcut defines the tagged Tiddler as a Keyboard Shortcut Tiddler, a container for actions that get triggered when its corresponding Keyboard Shortcut Descriptor in its key field matches a keyboard combination executed by the User
The system tag$:/tags/Macro/View marks macros that are only made available within the main view templates and the preview panel. It is now deprecated in favour of SystemTag $:/tags/Global/View.
The system tag$:/tags/Macro/View/Body marks macros that are only made available within the main view template bodies and the preview panel. It is now deprecated in favour of SystemTag $:/tags/Global/View/Body.
The system tag$:/tags/RawMarkupWikified marks wikified tiddlers to be included as raw markup at the bottom of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
Depuis : 5.1.18 The system tag$:/tags/RawMarkupWikified/BottomBody marks wikified tiddlers to be included as raw markup at the bottom of the <body> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
Depuis : 5.1.18 The system tag$:/tags/RawMarkupWikified/TopBody marks wikified tiddlers to be included as raw markup at the top of the <body> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
Depuis : 5.1.18 The system tag$:/tags/RawMarkupWikified/TopHead marks wikified tiddlers to be included as raw markup at the top of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
Un tiddler système correspond à tout tiddler dont le titre commence par $:/ ; de tels tiddlers sont automatiquement ignorés de plusieurs opérations. Ils n'apparaissent pas dans les listes des résultats de recherche, mais une liaison directe vers l'un d'eux fonctionne de façon classique.
TiddlyWiki considère tout comme un tiddler , y compris ses composants internes et sa configuration. Ainsi, même un TiddlyWiki, apparemment vide, contient, en fait, des dizaines de tiddlers nécessaires à son bon fonctionnement. L'emploie de tiddlers système évite les méprises des utilisateurs occasionnels.
TiddlyWiki fournit plusieurs macros permettant de générer une arborescence de liens vers des tiddlers à partir de l'analyse des tags :
toc
Un arbre simple
toc-expandable
Un arbre dont les branches peuvent être déployées ou rétractées
toc-selective-expandable
Un arbre dont les branches non-vides peuvent être déployées ou rétractées
toc-tabbed-internal-nav et toc-tabbed-external-nav
Une navigation en deux panneaux :
sur la gauche, une arborescence extensible sélectivement se comportant comme un ensemble d'onglets verticaux
sur la droite, le contenu du tiddler sélectionné par l'utilisateur dans l'arborescence
La différence entre ces deux derniers provient de ce qu'il advient lors d'un clic de l'utilisateur sur un lien du panneau droit :
toc-tabbed-internal-nav
Le tiddler cible s'affiche dans le panneau droit, remplaçant le tiddler contenant le lien
toc-tabbed-external-nav
Le tiddler cible s'affiche de façon classique (selon la configuration de l'affichage du déroulé par l'utilisateur)
Structure
Le premier niveau de l'arborescence est constitué de tiddlers qui portent une étiquette particulière, appelée tag racine. Les tiddlers marqués par l'un de ceux-là forment le niveau suivant, et ainsi de suite.
À chaque niveau, les tidllers peuvent être ordonnés
via le champ list de leur tiddler tag parent. Ils peuvent aussi être triés en paramétrant la macro sort
L'arborescence affiche le champ caption du tiddler s'il en a un, sinon son titre.
Chaque tiddler est affiché comme un lien, mais vous pouvez règler ceci en affectant la valeur no au champ toc-link du tiddler. Ainsi dans cet exemple, le tiddler SecondThree est affecté de la sorte. Cliquer sur un tel tiddler dans l'arborescence permettra de déployer ou rétracter sa branche.
La table des matières génère une liste HTML ordonnée. Les balises <ol> ont toujours la classe tc-toc. Les éléments d'arborescences déployables ont la classe additionnelle tc-toc-expandable. Les arborescence déployables sélectivement (dont celles du deuxième panneau de navigation) sont munies de tc-toc-selective-expandable.
Ces deux paramètres sont combinés en une seule expression de filtre de cette façon :
[tag[$tag$]$sort$]
toc-tabbed-internal-nav et toc-tabbed-external-nav ont, en sus, d'autres paramètres :
selectedTiddler
Le titre du tiddler d'état attribué au tiddler en cours sélectionné, par défaut $:/temp/toc/selectedTiddler. Il est recommandé d'employer un tiddler système
unselectedText
Le texte affiché quand aucun tiddler n'est sélectionné dans l'arborescence
missingText
Le texte affiché si le tiddler sélectionné est manquant
template
De manière optionnelle, le titre du tiddler gabarit lors de la transclusion du tiddler sélectionné dans le panneau de droite
La macro TableOfContents (Table des Matières) produit une arborescence hiérarchique de tiddlers, en se basant sur leurs tags.
Les entrées de premier niveau de la table des matières sont définies par un tag racine. Les sous-entrées de chacune de ces entrées sont taguées avec le titre de l'entrée. Les entrées peuvent être triées à l'aide du champ list du tiddler de tag correspondant, comme décrit dans Tagging.
Le libellé utilisé pour chaque entrée est tiré du champ caption s'il est présent ; dans le cas contraire, c'est le titre (champ title) qui est utilisé.
Les entrées sont affichées sous forme de liens vers le tiddler correspondant, à moins que le tiddler contienne un champ toc-link avec la valeur no. Dans les exemples ci-dessous, l'entrée SecondThree est configurée ainsi, de manière à ne pas apparaître comme un lien.
Il existe plusieurs variantes de cette macro :
<<toc>> produit une arborescence hiérarchique de liens simple
<<toc-expandable>> produit une arborescence de liens développable
<<toc-selective-expandable>> produit une arborescence de liens développable où les boutons développer / contracter ne sont affichés que pour les entrées qui possèdent des nœuds fils
Les macros génèrent des listes HTML ordonnées. Les éléments <ol> bénéficient de la classe tc-toc, ceux de la variante expandable bénéficiant également de la classe tc-toc-expandable tandis que ceux de la variante selective expandable bénéficient de la classe tc-toc-selective-expandable.
Paramètres
Position
Nom
Description
Défaut
1re
tag
Le tag racine qui identifie le premier niveau de la hiérachie
2e
sort
Sous-fitre optionnel de tri (par exemple sort[title])
Les paramètres tag et sort sont combinés pour construire une expression de filtre de la forme :
[tag[$tag$]$sort$]
Exemples
Dans les exemples suivants, les entrées de premier niveau de la table des matières sont définies par leur tag racine Contents. Les sous-entrées sous chacune de ces entrées sont taguées avec le titre de leur parent, ici First, Second, Third, et Fourth. Au niveau du dessous, seul SecondThree comporte des sous-entrées.
Voici la structure des tags, affichée à l'aide de pastilles de tag cliquables :
TiddlyWiki5 forme les tableaux au moyen du signe barre verticale |, de cette façon :
|!Cell1 |!Cell2 |
|Cell3 |Cell4 |
Le point d'exclamation marque les cellules d'entête :
Cell1
Cell2
Cell3
Cell4
L'alignement horizontal
L’alignement horizontal des cellules du tableau est contrôlé par l'insertion d'un espace avant/après le contenu de la cellule. Par exemple:
|Contenu aligné à gauche |
| Contenu aligné à droite|
| Contenu centré |
|+++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++|
Affichera ceci :
Contenu aligné à gauche
Contenu aligné à droite
Contenu centré
+++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++
L'alignement vertical
L’alignement vertical des cellules du tableau est contrôlé par l'insertion, comme premier caractère de la cellule, soit d'un ^ pour un alignement en haut ou un , pour un alignement en bas. La combinaison avec l'alignement horizontal reste valable.
Exemple :
| ::<br>:: |^haut gauche |^ haut centré |^ haut droit|
| ::<br>::<br>:: |milieu gauche | milieu centré | milieu droit|
| ::<br>::|,bas gauche |, bas centré |, bas droit|
Affichera ceci :
:: ::
haut gauche
haut centré
haut droit
:: :: ::
milieu gauche
milieu centré
milieu droit
:: ::
bas gauche
bas centré
bas droit
Si vous voulez afficher un ^ou un , comme premier caractère d'une cellule alignée à gauche, vous devez utiliser la technique de l'« échappement html ». Voir, à ce sujet : Mise en forme en WikiTexte.
^
^
,
,
La fusion des cellules
Pour fusionner le contenu de la cellule située au dessus utiliser ~. Pour fusionner avec celle de gauche < et > pour celle de droite. Par exemple :
WikiText tables can be styled by applying CSS classes. For basic information on wiktext tables and how to style them, see Tables in WikiText.
Table CSS classes, captions, headers and footers can be specified as special pseudo-rows. The following example:
|myclass anotherClass|k assigns the CSS classes "myclass" and "anotherClass" to the table
|This is a caption |c gives the table the caption "This is a caption"
|Header|Header|h adds a header row of cells with the text "Header"
|Footer|Footer|f adds a footer row of cells with the text "Footer"
|myclass anotherClass|k
|This is a caption |c
|Cell1 |Cell2 |
|Cell3 |Cell3 |
|Header|Header|h
|Footer|Footer|f
Affichera ceci :
This is a caption
Cell1
Cell2
Cell3
Cell3
Header
Header
Footer
Footer
As seen above, the resulting table is left aligned and grows to fit the content. This is the browser default layout behaviour for tables. To get another behaviour, various CSS classes can be added into the "k row".
Utility Classes
Depuis : 5.2.4 The following outlines a few predefined CSS classes intended to make it simpler to style HTML block-elements and wikitext tables.
General Utility Classes
tc-center
Centres a block-element to the middle of the container
tc-max-width
Expands a block-element to use the maximum width of the container
tc-max-width-80
Sets the width of a block-element to use 80% of the maximum container width. This setting is useful with the tc-center class
Ensures that any links in the first table column will never wrap to the next line
Table Utility Classes
tc-table-no-border
Removes the borders of a table
tc-first-col-min-width
The first column of a table will take up minimal possible width. It adapts to the content
Examples
The following examples apply the style classes to tables but the "General Utility Classes" can as well be used on DIVs or other HTML block elements
Centred Table
To center a table horizontally, use tc-center:
|tc-center|k
|This is a caption |c
|Cell1 |Cell2 |
|Cell3 |Cell4 |
|Header|Header|h
|Footer|Footer|f
Affichera ceci :
This is a caption
Cell1
Cell2
Cell3
Cell4
Header
Header
Footer
Footer
Centred Table, 80% Width
To add empty left and right margins to a table that is otherwise full-tiddler-width, you can use tc-max-width-80
|tc-center tc-max-width-80|k
|This is a caption |c
|Cell1 |<<.lorem>> |
|<<.lorem>> |Cell4 |
|Header|Header|h
Affichera ceci :
This is a caption
Cell1
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Cell4
Header
Header
Table with Maximum Width
To expand a table to full tiddler width, use tc-max-width
The following is a table with maximum width. It contains TextWidgets with maximum width. The first column is set to be minimum width. Further, all links in the first column are set to not line break (wrap) regardless of window resize.
|tc-max-width tc-first-col-min-width tc-edit-max-width tc-table-no-border tc-first-link-nowrap|k
| Cell1|<$edit-text tiddler="$:/temp/test-table-input" tag="input" field="test"/> |
|^ [[Link to a tiddler]]<br>some more text|<$edit-text tiddler="$:/temp/test-table-input" field="text"/> |
The tabs display the caption field of a tiddler if it has one, or the tiddler's title otherwise. If specified, the tabs display the tooltip field of a tiddler as the respective button tooltip.
By default the tabs are arranged horizontally above the content. To get vertical tabs, set the class parameter to tc-vertical.
The title of the tiddler whose tab is to be selected by default, if the state tiddler doesn't exist. The state tiddler takes precedence over this setting
state
The prefix for the title of a state tiddler for noting the currently selected tab, defaulting to $:/state/tab. It is recommended that this be a system tiddler
class
Additional CSS classes for the generated div elements. Multiple classes can be separated with spaces
template
Optionally, the title of a tiddler to use as a template for transcluding the content of the selected tab
buttonTemplate
Optionally, the title of a tiddler to use as a template for transcluding the content of the button for the selected tab
retain
Optionally, "yes" specifies that the content of the tabs should be retained when switching to another tab, avoiding re-rendering it (this can be useful to avoid video or audio sources unexpectedly resetting)
actions
Optionally, actions can be specified that are triggered when changing a tab. Within the actions, the title of the selected tab is available in the currentTab variable and the currentTiddler variable from outside the tabs macro is available in the save-currentTiddler
explicitState
Optionally, an explicit state title can be specified. It will be preferred over the internally computed (qualified) state title
Within the template, the title of the selected tab is available in the currentTab variable.
The currentTiddler variable is not affected by the tabs macro. This can put you in trouble if the list of tabs includes tiddlers that depend on the value of the currentTiddler, for example tiddlers listing children based on its own name. To overcome this problem you can use a TemplateTiddler like the following:
La macro tabs affiche une liste de tiddlers sous forme d'onglets. L'utilisateur peut passer d'un onglet à l'autre en cliquant. Les onglets sont étiquetés avec le titre du tiddler correspondant, sauf si un champ caption est présent, auquel cas c'est celui-ci qui est utilisé.
Par défaut, les onglets sont disposés horizontalement, le contenu étant affiché en-dessous. Vous pouvez aussi disposer les onglets verticalement en passant en paramètre la classe tc-vertical.
Paramètres
Position
Nom
Description
Défaut
1re
tabsList
Filtre indiquant les tiddlers à afficher
2e
default
Nom du tiddler contenant l'onglet qui s'affichera par défaut
3e
state
Chaîne de caractères permettant de distinguer plusieurs ensembles d'onglets présents dans le même tiddler (l'utilisation du préfixe des tiddlers système est recommandée)
Classes CSS supplémentaires pour les trois DIVs imbriquées qui construisent les onglets (vous pouvez indiquer plusieurs classes en les séparant avec des espaces)
5e
template
Un tiddler template optionnel via lequel le contenu de l'onglet doit être rendu
À l'intérieur du template, le titre de l'onglet courant est accessible via la variable currentTab. La variable currentTiddler n'est pas modifiée par la macros tabs.
Exemples
Voici quelques exemples d'utilisation de la macro tabs. Notez que l'édition française de la documentation utilise le champ caption pour faire apparaître le titre de l'onget en Français :
The tag macro generates a tag pill for a specified tag. Clicking the tag pill opens a dropdown. This can be compared to the tag-pill Macro which also features other parameters.
If a list widget generates multiple tag macros for the same tag, clicking on one of them will open dropdowns on all of them. The simplest way to prevent this is to add the counter="transclusion" attribute to the list widget. See the examples below for more details.
If a list widget generates multiple tag macros for the same tag, clicking any of them opens dropdowns on all of them, as in the example below. This is usually unwanted.
Adding the counter="transclusion" attribute to the list widget that generates multiple identical tag macros causes each of them to be identified as a unique one. Clicking on any of them opens only a single dropdown.
A slightly more performant option is to use the variable="transclusion" attribute in the list widget. In this case, the variable <<transclusion>> has to be used inside the list widget instead of the <<currentTiddler>> .
L'étiquetage des tiddlers permet de les organiser en catégories. Par exemple, les tiddlers représentant des individus pourraient être étiquetés avec les tags ami, famille, collègue, etc. pour indiquer leur relation avec l'auteur.
Un tag est en fait un simple tiddler (ou un tiddler potentiel), qui peut lui-même avoir ses propres tags. Plusieurs tags peuvent être appliqués au même tiddler.
Le fait d'étiqueter les tiddlers vous procure de nombreux moyens supplémentaires de visualiser, parcourir, et organiser vos informations :
Les pastilles colorées pour chaque tag d'un tiddler vous donnent accès à tous les autres tiddlers portant le même tag, ainsi qu'au tiddler correspondant au tag lui-même.
Lorsqu'un tiddler est utilisé pour étiqueter d'autres tiddlers, l'onglet Étiquetage dans son panneau d'informations liste tous les tiddlers tagués avec le titre du tiddler courant.
L'onglet Plus de la barre latérale contient un onglet Tags qui permet de visualiser tous vos tags et d'accéder à vos tiddlers étiquetés.
Vous pouvez utiliser des filtres pour créer des listes de tiddlers selon leurs tags, puis afficher toute combinaison de champs souhaitée. Par exemple, vous pouvez créer un glossaire en listant le titre et le texte de tous les tiddlers étiquetés Glossaire. De telles listes peuvent être formatées à votre goût : avec des puces, des nombres, ou séparées par des virgules, etc.
Encore deux choses que les tags permettent de faire :
Affecter des couleurs et des icônes à un tag
Vous pouvez utiliser le gestionnaire de tags, présent dans l'onglet Tags de l'onglet Plus de la barre latérale, pour affecter une couleur de fond et/ou une icône à un tag.
Les couleurs peuvent être affectées à un tag en cliquant sur le bouton de la colonne des couleurs et en sélectionnant une proposition. Sinon, spécifiez la valeur CSS de la couleur dans la zone de saisie accessible en cliquant sur le bouton .
Les icônes peuvent être affectées à un tag en cliquant sur le bouton dans la colonne des icônes et en choisissant une des icônes proposées.
Changer l'ordre dans lequel les tiddlers sont listés
Par défaut, les tiddlers tagués sont listés dans l'ordre alphabétique.
Si vous voulez un ordre différent, ajoutez un champ list au tiddler du tag, et affectez lui comme valeur la liste de ses tiddlers dans l'ordre choisi.
Le champ list n'a pas besoin de contenir tous les tiddlers. TiddlyWiki utilise des règles précises pour trier les tiddlers tagués.
Each input tag is processed in turn. The list of tiddlers carrying that tag is generated, sorted, and then dominantly appended to the operator's overall output.
Each input title is processed in turn. The corresponding tiddler's tags are retrieved (in order of appearance in the tags field) and then dominantly appended to the operator's output.
TiddlyWiki5 peut servir de système de gestion de tâches simple sans personnalisation supplémentaires. L'idée est que les tâches soient taguées avec task, celles étant terminées portant également le tag done. De cette manière, il est très simple de générer des listes de tâches.
Lors de la rédaction d'un tiddler d'apprentissage, commencez par planifier la route des informations que vous souhaitez présenter. Ce doit être un cheminement simple, logique, progressif, sans retour en arrière ou référence à suivre.
Employez cette méthode, même lors d'expressions indépendantes : toujours aller de la cause à l'effet, de l'ancien ou connu vers le nouveau ou l'inconnu. Une phrase technique claire contient rarement plus d'une idée. Elle évite donc les informations entre parenthèses. De même, garder une structure de paragraphe simple. Une présentation linéaire est souvent plus facile à comprendre que si elle est hiérarchisée.
Il est souvent possible de simplifier une phrase sans changer sa signification, simplement en ajustant son vocabulaire ou sa structure grammaticale. "le processus de la macro est exécutée" signifie simplement "La macro s'exécute". "Votre attente pourrait être ..." signifie simplement "Vous pourriez attendre ...".
Préférez la voix active par défaut : "Jane créé un tiddler" plutôt que "un tiddler est créé par Jane". La voix passive peut être utile si vous voulez focaliser l'attention du lecteur sur l'action elle-même ou sur son résultat : "un tiddler est créé". Mais il est souvent plus clair d'aller de la cause à l'effet et dire en voix active, "Cela créé un tiddler".
La documentation présente souvent deux éléments en parallèle par similarité ou par différence. Le lecteur pourra plus facilement appréhender des concepts si vous employez la même structure de phrase pour chacun. Mais c'est contrebalancé par la nécessité de rompre la monotonie.
Préférez les instructions précises aux discours verbeux. Si quelque chose a un nom, l'utiliser. Si quelque chose n'a pas de nom, lui attribuer un tiddler.
Un tiddler gabarit n'est pas vraiment un type de tiddler, c'est un rôle dans lequel un tiddler peut être utilisé.
Les gabarits sont un moyen de réutiliser différentes portions de WikiTexte.
Transclure par un gabarit étend les fonctionnalités de base de la Transclusion en combinant deux tiddlers :
Un tiddler gabarit contenant le WikiTexte à afficher. Il peut contenir des transclusions se référant aux champs du tiddler en cours
Un tiddler cible qui indique quel tiddler sera considéré comme en cours lors des calculs de références des champs
Le meilleur exemple de modélisation est le flux principal des tiddlers ouverts de TiddlyWiki. Chaque tiddler du déroulé principal est affiché via un Gabarit d'affichage qui spécifie le rendu de chaque champ.
Avec TiddlyWiki, vous pouvez organiser vos notes selon vos préférences, pas selon celle des autres. Vos notes se conforment à votre façon de penser et personne ne vous impose une hiérarchie prédéfinie de carnets de notes ou d'onglets.
L'approche non-linéaire de TiddlyWiki vous donnera l'occasion de penser à vos informations d'une façon effectivement nouvelle et utile.
Retrouver ses notes dans TiddlyWiki est ultra-rapide.
Il existe de nombreux moyens de personnaliser et d'adapter tous les aspects de TiddlyWiki.
TiddlyWiki est libre et gratuit, et compatible avec toutes les plates-formes. N'importe quel navigateur web pourra l'ouvrir. Pour l'utiliser, il n'est pas nécessaire d'acquérir une application coûteuse, ni de payer un abonnement.
Les fichiers TiddlyWiki facilitent le partage d'informations. Il existe une multitude de manières de partager vos informations depuis TiddlyWiki.
Avec TiddlyWiki, vos informations vous appartiennent, et vous les stockez où vous voulez — sur notre appareil, sur une clé USB, dans Dropbox, sur votre serveur.
TiddlyWiki propose un nombre toujours croissant de plugins, thèmes, widgets, et langages.
La communauté en ligne de TiddlyWiki est bienveillante, et fera de son mieux pour vous apporter l'aide dont vous avez besoin.
Si vous êtes programmeur, vous trouverez encore plus de façons de faire joujou avec TiddlyWiki. Avec TiddlyWiki, plus on en sait, plus on s'amuse.
The TiddlyWiki is the best software I've ever found for organising my ideas.
It's well worth spending an hour or so playing with it to see how it can help you. This will be time well-spent and will change how you think and how you organise your ideas.
Pressing the eye icon will open or close a preview window showing the results of rendering the WikiText (the icon-eye will also open or close).
Right to the eye there is another icon, , which when clicked, shows you a dropdown which gives you access to six different types of preview:
output shows you the text as you see it when you do not edit the tiddler.
html shows you the source code of that output. Your web browser uses this source code to display webpages.
parsetree and widgettree show you the two object trees that TiddlyWiki internally generates from WikiText. The parsetree collects basic information about your WikiText. From the informations of the parsetree the widgettree then generates extended informations and finally the above html (and the widgettree also does other things).
differences from current shows you the differences since the tiddler was last saved. Deleted parts are red, added parts are green.
differences from shadow (if any) does the same, but this time it shows you the differences to the underlying shadow-tiddler.
By default, the preview pane button controls whether the preview pane is displayed for all tiddlers that are open for editing. There is a hidden setting to make the button work on a per-tiddler basis
The variable tv-tiddler-preview can be used to detect whether content is being displayed in the preview pane.
Il arrive régulièrement que des utilisateurs de TiddlyWiki nous rapportent des histoires à tordre le cœur concernant des pertes de données personnelles dans les groupes de discussion :
Tout mon TiddlyWiki s'est volatilisé lorsque Firefox a crashé pendant l'enregistrement d'un tiddler.
La dernière fois que je l'ai utilisé, c'était hier soir à la maison sur mon ordinateur Windows 7 ; j'ai cliqué sur la coche de validation pour terminer d'éditer ma dernière note, ce qui a déclenché l'enregistrement via TiddlyFox, et j'ai éjecté ma clé USB. Je suis arrivé au bureau ce matin, j'ai branché ma clé USB, entré mon mot de passe TW5, mais il n'a pas voulu s'ouvrir après plusieurs tentatives. J'ai exploré mes répertoires à la recherche de mon fichier html TW5 et j'ai remarqué qu'il ne pesait plus 3Mo, mais 80Ko. Ce qui me conduit à penser que j'ai tout perdu.
Arrangez-vous pour que cela ne vous arrive jamais !
La première règle d'utilisation de TiddlyWiki est
Sauvegardez vos données !
TiddlyWiki est un système très souple et personnalisable, qui vous rend responsable de vos données. Un grand soin est porté lors du développement de TiddlyWiki à s'assurer que c'est un lieu sûr pour préserver vos données les plus précieuses, mais au bout du compte, c'est aux utilisateurs que revient la responsabilité de limiter les risques d'une perte de données.
La meilleure façon de s'assurer que vos données sont en sécurité est de mettre en œuvre une procédure de sauvegarde rigoureuse :
Pensez à utiliser des services du type Dropbox pour sauvegarder continuellement vos données personnelles sur le cloud. (Dropbox dispose d'une fonctionnalité intéressante grâce à laquelle vous pouvez garder la trace des versions précédentes de vos fichiers)
Faites des sauvegardes avant de passer à une nouvelle version de TiddlyWiki
Protégez-vous des pires scénarios imaginables : que ce passerait-il si votre clé USB ou votre disque dur tombe en panne. Et si votre ordinateur est attaqué par un virus de la pire espèce ?
Soyez sur vos gardes et pratiquez la redondance : par exemple, ayez plusieurs exemplaires de vos sauvegardes, et conservez-les dans des endroits physiquement séparés.
The major difference between the then operator and a :then prefixed filter run is that the operator will replace each item of the input Title List with its parameter while :then will replace the whole input list with the result of its run.
:then Filter Run Prefix
then Operator
[tag[WikiText]] :then[[true]]
[tag[WikiText]then[true]]
To make them equivalent, additional filter steps may be added:
The :then filter run prefix can be combined with the :else prefix to create conditional filters. In this example, the fields used in searchSubfilter for searching depend on the value of $:/temp/searchFields and the sort order used by sortSubfilter depends on the value of $:/temp/searchSort. Checkboxes are used to set the values of these tiddlers.
Note that each filter run of the subfilter receives the input of the subfilter operator as input
Since the then and else operators cannot call subfilters or perform additional filter steps, they cannot be used for such applications.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Depuis : 5.3.0 The thisTiddler variable is set by the $transclude widget to contain the title of the tiddler that was transcluded. This means that within transclusions thisTiddler will contain the title of the transcluded tiddler. It is not affected by macros, which means that within a macro thisTiddler will contain the title of the tiddler from which the macro was invoked. Intermediate, nested macro calls are ignored.
There are two key usages for thisTiddler:
Within a transcluded template, thisTiddler points to the template itself, making it possible for the template to access data stored in other fields of the template
Within a macro, thisTiddler points to the template that invoked the macro. If the macro was invoked by another macro, the template that invoked that macro is returned, and so on
Here is an example of the thumbnail-right macro used to create a video thumbnail that floats to the right of the text
<<thumbnail-right link:"Introduction Video" image:"Introduction Video Thumbnail.jpg" caption:"Introduction to ~TiddlyWiki" icon:"{{$:/core/images/video}}" color:"red">>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Title operation: add, remove prefixes and suffixes, also remove cahras form begining and end of title (on renaming tiddlers, relink can be used to update title in other tiddlers)
Tag operation: add, remove, replace
Field operation: add, remove, rename, and set field value
SnR, search and replace in all fields including text, tags, title, and common fields
Inspect, to review and inspect tiddlers in one place, scroll among them and edit all fields (including common fields), tags, text (title is an exception!)
Log, create logs of all operations
Search, save and load any combination of filter search
Suivant la Philosophie des tiddlers, la documentation des tiddlers est typiquement courte et interconnectée.
Quand un tiddler semble nécessiter des subdivisions, c'est souvent le signe qu'il devrait être fractionné en plusieurs tiddlers. Mais il est raisonnable pour un tiddler de référence de se décomposer en une section d'introduction non titrée, suivie d'une section titrée pour les détails.
La cohérence de la terminologie est essentielle pour éviter la confusion du lecteur. La cohérence de la typographie et de la ponctuation offrent une qualité professionnelle à la documentation. Les macros peuvent participer à l'amélioration de la cohérence du texte et de sa maintenabilité .
Utilisez les listes numérotées pour les instructions pas-à-pas, et les puces pour les listes dont l'ordre est arbitraire. Utilisez une liste de définitions de préférence à une liste à puces si chaque élément de la liste débute par un terme suivi d'une virgule. Autant que possible, évitez de surcharger le lecteur avec une liste hiérarchisée.
Utilisez une table lorsque l'information se divise naturellement en trois colonnes ou plus, ainsi que pour les listes de paramètres, d'attributs, etc., au sein des tiddlers de référence.
La documentation reflète la réalité actuelle de TiddlyWiki. Elle évite les discussions sur ses aspirations.
Plusieurs tiddlers documentaires, particulièrement les référents, sont concernés par un seul concept. Leurs titres doivent correspondre à un groupe nominal succinct comme List Widget ou Champs de Tiddler.
Chacun des mots principaux d'un tel titre commence avec une majuscule. Les mots mineurs comme "et", "ou", "le", "de" and "avec" n'en ont pas.
Les Tags suivent aussi ce modèle.
Les titres de ce genre sont au pluriel s'ils représentent une catégorie d'articles, comme. Raccourcis Clavier ou Champs de Tiddler. Cette forme est utilisée pour étiqueter des tiddlers plus spécifiques dans une catégorie.
Quand un concept est un article plus qu'une catégorie, son tiddler a titre particulier, comme : List Widget, tag Operator.
Commencer un titre avec sa partie la plus distinctive. Par exemple, les tiddlers documents, les opérateurs de filtre ont des titres comme addprefix Operateur. Cela aide le lecteur a parcourir une liste de liens pour trouver un tiddler particulier.
Éviter de commencer un titre avec un article comme "le, la, les" ou "un, une, des".
Par le passé, plusieurs tiddlers avaient des titres CamelCase. C'est progressivement abandonné pour accroître la lisibilité. Les titres CamelCase ne seront plus employés, même pour les tags, exceptés pour les cas comme JavaScript où il existe une orthographe standard.
Les tiddlers d'apprentissage ont souvent des titres long un peu plus élaborés qu'un simple groupe nominal, comme : Dix raisons de passer à TiddlyWiki. Ces titres suivent la règle de la phrase, où seul le premier mot (ainsi que tous noms propres) commence par une majuscule.
Les tiddlers Comment ? ont des titres qui débutent par "Comment ?", de type : Comment éditer un tiddler. Éviter les titres comme :Tiddlers Edition, car un locuteur moyen pourrait ne pas l'interpréter comme le nom d'une catégorie de tiddlers.
Les champs de tiddlers sont les couples nom:valeur qui constituent un tiddler. Les noms de champ peuvent être composés de lettres minuscules non accentuées, chiffres, ou caractères - (tiret), _ (souligné) et . (point).
Les tiddlers peuvent être conservés dans des fichiers texte dans plusieurs formats différents. Les fichiers contenant un seul tiddler peuvent aussi avoir un fichier .meta auxiliaire formaté comme une suite de paires nom:valeur :
title: LeTitre
Fichiers .tid à la TiddlyWeb
Ces fichiers consistent en une séquence de paires nom:valeur, suivie d'une ligne blanche, puis du texte du tiddler. Par exemple :
title: MonTiddler
Voici le texte de mon tiddler.
Notez que de nombreux éditeurs de texte imposent que les fichiers se terminent par un caractère de « nouvelle ligne ». Si vous voulez éviter qu'une ligne soit ajoutée à la fin de votre texte, vous pouvez utiliser cette autre syntaxe :
title: MonTiddler
text: Voici le texte de mon tiddler.
Le ContentTypeapplication/x-tiddler est utilisé en interne pour ces fichiers
Fichiers <DIV> avec l'extension .tiddler
Les fichiers *.tiddler modernes ressemblent à ça :
<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">
<pre>Notez qu'il y a une balise <pre> embarquée, et que les retours à la ligne ne sont pas échappés.
Et bizarrement, aucun codage HTML dans le corps du tiddler.</pre>
</div>
Ces fichiers *.tiddler ne sont donc pas vraiment similaires aux tiddlers trouvés à l'intérieur d'un fichier HTML TiddlyWiki, dans lequel le corps du texte est encodé en HTML comme attendu.
Les anciens fichiers *.tiddler étaient plus proches du format de stockage utilisé par TiddlyWiki à l'époque :
<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">Voici un fichier tiddler à l'ancienne, sans balise <pre> embarquée. \nVoyez comme le corps du tiddler est "codé en HTML" et les sauts de ligne échappés par \\n</div>
Le ContentTypeapplication/x-tiddler-html-div est utilisé en interne pour ces fichiers
Fichiers JSON de type TiddlyWeb
Ces fichiers sont des tableaux de hachages sans fioritures contenant des champs sous la forme name:value. À présent seuls ces champs standards sont traités : title, text, created, creator, modified, modifier, type et tags.
Le ContentTypeapplication/json est utilisé en interne pour ces fichiers
Fichiers TiddlyWiki HTML
Les fichiers TiddlyWiki HTML contiennent une collection de tiddlers encodés au format <DIV>.
Pour qu'un fichier HTML soit importable comme un fichier TW non crypté, il faut au minimum qu'il contienne un <div id="storeArea"> juste avant les DIVs des tiddlers, eux-mêmes suivis immédiatement par un </div>. Par exemple :
<div id="storeArea">
<div created="20130302085406905" modified="20130302084548184" tags="Exemples" title="Un titre de tiddler">
<pre>Texte d'un tiddler encodé en HTML
</pre>
</div>
<div created="20140315085406905" modified="20140321084548184" tags="Un Deux [[Trois avec espace]]" title="Un autre titre" champperso="valeur du champ">
<pre>Texte de ce tiddler
</pre>
</div>
Les liens sont des éléments d'un tiddler où cliquer engendre la navigation vers un tiddler différent. Le comportement d'une navigation est déterminé par le StoryView (la vue) en cours : par défaut, la vue classique de TiddlyWiki montre son déroulé comme une suite linéaire de tiddlers.
Presser la touche control ou command en cliquant sur le lien d'un link ouvre le tiddler cible sans s'y déplacer. Cela peut-être un moyen pratique de dresser une suite de tiddlers à lire plus tard.
Les liens sont utiles pour modéliser des relations organiques entre tiddlers, et notamment pour décrire les chemins de navigations entre tiddlers.
Le panneau d'information liste la provenance des liens vers un tiddler dans l'onglet References.
Les filtres peuvent inclure les opérateur de filtrage suivant qui fonctionnent avec les liens :
[links[]] - renvoie les titres des tiddlers dont les liens proviennent de la sélection des tiddler(s) en cours
[backlinks[]] - renvoie les titres des tiddlers destination des liens des tiddler(s) en cours sélectionnés
TiddlyWiki5 modifie l'apparence des liens des tiddlers pour donner plus d'informations sur la cible du lien :
Les tiddlers représentent l'unité d'information fondamentale dans TiddlyWiki. Plus les tiddlers sont petits mieux ils fonctionnent, car il est alors plus facile de les réutiliser en les assemblant de différentes manières.
D'autres systèmes disposent de concepts analogues nommés de façon confusément générique, du style « items », « entrées », « entités » ou « enregistrements ». TiddlyWiki considère qu'il est préférable d'être confusément distinct.
Les tiddlers sont représentés en interne par des listes de valeurs nommées appelées « champs ». Le seul champ obligatoire est le champ title, mais pour être utiles, les tiddlers comportent aussi un champ text, et tout ou partie des champs standard énumérés dans TiddlerFields.
ChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaSafariEnregistrer les modificationsWindows
TiddlyBucket - Save to AWS or Google Storage using Go
This tool replicates the TiddlyWeb backend API and can read and write the tiddler files to a local directory like the canonical TiddlyWiki5 app. But, in addition, it can do the same with a given a Google Cloud Storage bucket or AWS S3 bucket. Written in the Go programming language
TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
TiddlyDesktop est une application pour travailler avec les fichiers TiddlyWiki (TiddlyWikiClassic et TiddlyWiki version 5). Il peut être installé sur Windows, Mac OS X or Linux. Il est compatible avec TiddlyWiki version 5 ou l'ancien TiddlyWikiClassic.
TiddlyFox est une extension pour Firefox qui permet aux fichiers TiddlyWiki autonomes d'enregistrer leurs modifications directement sur le système de fichiers. TiddlyFox fonctionne aussi bien sur les versions station de travail que mobile de Firefox. Voir Enregistrer avec TiddlyFox ou Enregistrer avec TiddlyFox pour Android pour des instructions détaillées.
TiddlyFox est maintenant obsolète car il n'est plus compatible avec les dernières versions de Firefox (voir L'apocalypse de TiddlyFox). Il existe de nombreuses alternatives à TiddlyFox, mais aucune ne fonctionne exactement de la même façon. Voir La mise en route pour plus d'informations.
TiddlyFox peut être téléchargé depuis le site Mozilla Addons :
Le 14 novembre 2017 Mozilla a publié Firefox 57, une nouvelle version majeure comprenant de nombreuses améliorations et correctifs de sécurité. Toutefois, ces améliorations comportaient des changements fondamentaux du modèle de sécurité qui ont eu comme effet indésirable d'empêcher TiddlyFox de fonctionner.
Heureusement, il existe de nouvelles façons de travailler avec TiddlyWiki et les utilisateurs ont de nombreux choix alternatifs (voir les détails dans La mise en route). La disparition de TiddlyFox a provoqué plusieurs de ces développements récents et pourrait finalement être bénéfique pour la communauté.
Firefox a été initialement publié en novembre 2004, quelques mois après la première version de TiddlyWiki. C'était très comparable au Faucon Millénium pour l'Étoile de la Mort de Microsoft (incarnée par Internet Explorer). IE écrasait depuis 5 ans le marché des navigateurs, provoquant la frustration de nombreux développeurs web face aux extensions au HTML de Microsoft qui étaient devenus des standards de facto au détriment d'une innovation qui aurait pu bénéficier à l'ensemble de la communauté web.
Firefox a vite eu du succès car il réussissait à afficher les pages web avec un rendu assez proche d'Internet Explorer tout en offrant une meilleure expérience utilisateur. Ses avantages résidaient en grande partie dans la possibilité offerte à l'utilisateur de modifier chaque aspect du navigateur. Deux innovations étaient à l'origine de cette capacité :
L'intégralité de l'interface utilisateur du navigateur était écrite en XUL, une extension au HTML qui lui permettait d'afficher des interface utilisateur conventionnelles (à l'époque, le HTML était limité à un simple rendu de documents structurés). Ajuster quelques lignes de code en XUL pouvait radicalement transformer l'interface du navigateur.
L'architecture d'extensions de Mozilla donnait les pleins pouvoirs aux extensions, leur permettant d'observer et d'interagir profondément avec le moteur du navigateur lui-même, ainsi qu'avec le système de fichiers de l'ordinateur sur lequel il s'exécutait.
Ces deux conditions permirent l'épanouissement d'un large écosystème d'extensions autour de Firefox, pour certaines extrêmement populaires. Dans de nombreux cas, les innovations apportées par des extensions furent ensuite intégrées dans le navigateur, en particulier le débogueur Firebug qui fut par la suite cloné par tous les éditeurs de navigateurs.
Firefox resta très populaire jusqu'à ce que Google rejoigne le développement du moteur rival WebKit pour développer Chome. Google choisit une approche très différente des compromis au cœur d'un navigateur, se concentrant sur l'amélioration de la sécurité au détriment de toute autre considération. Ils innovèrent avec l'isolation de chaque onglet dans un processus dédié, qui fut rapidement repris par les principaux navigateurs concurrents.
L'orientation de Google les empêcha d'adopter l'approche libertaire de Mozilla pour les extensions. Au lieu d'avoir accès à tout l'environnement du navigateur et au système, les extensions de Chrome ne voient qu'une petite partie de ce qui se passe dans le navigateur, et n'ont qu'un accès minimal aux ressources de l'hôte.
Le ralliement de Mozilla à l'approche de la sécurité des extensions de navigateurs de Google était inévitable. A ce point, Mozilla aurait été irresponsable de publier un navigateur construit sur un modèle de sécurité notoirement inférieur à celui du leader du marché.
Leçons
Une partie de la fécondité de l'écosystème autour de TiddlyWiki provient de l'adoption des deux principes de Firefox cités précédemment :
Construire l'interface utilisateur de l'application avec les mêmes primitives que son contenu
Permettre aux extensions d'accéder et interagir librement avec la logique interne de l'application.
Ces deux caractéristiques confrontent TiddlyWiki aux mêmes défis de sécurité que Firefox en son temps. Un TiddlyWiki orienté principalement vers la sécurité serait contraint de réduire ces possibilités.
Le futur
Dans le domaine des interfaces basées sur les navigateurs et des interactions utilisateur, l'innovation a maintenant quitté les extensions pour migrer vers une nouvelle génération d'environnements qui simplifient la créations de navigateurs sur-mesure basés sur des moteurs de rendu HTML libres sur étagère. Ainsi, TiddlyDesktop utilise nwjs, et Beaker Browser utilise une alternative nommée Electron.
Tiddlyhost.com is a hosting service for TiddlyWiki created by Simon Baird. Once you sign up and confirm your email you can create "sites", (i.e. TiddlyWikis), with support for online saving. Sites can be private or public, and you can optionally list them on the taggable and searchable Tiddlyhost Hub where they'll be discoverable by others.
Unlike TiddlySpot, Tiddlyhost is secure, open source, and has proper support for TiddlyWiki5. It also allows uploading existing TiddlyWiki files, supports TiddlyWikiClassic, and lets you claim ownership of your TiddlySpot sites. For more information see the FAQ and the About page.
TiddlyIE is an extension for Internet Explorer that allows standalone TiddlyWiki files to save their changes directly to the file system. TiddlyIE works with the desktop version of Internet Explorer.
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
Create concept maps and quickly manifest your ideas in tiddlers.
Create task-dependency graphs to organise and describe your tasks.
Visualise your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualise and describe any network-structure you have in mind.
LinuxMacOther ResourcesEnregistrer les modificationsWindows
Une extension à la configuration du serveur Node.js de TiddlyWiki qui ajoute la prise en charge des contenus statiques et permet de travailler avec de multiples wikis simultanément.
TiddlyServer prend la commande server de TiddlyWiki sur Node.js, et l'ajoute à un serveur de fichiers statiques. Ça signifie que vous pouvez charger et héberger n'importe quel dossier de donnéesTiddlyWiki de la même façon qu'un TiddlyWiki mono-fichier.
Mais vous n'êtes pas limité à un seul emplacement pour vos fichiers et dossiers partagés, vous pouvez les partager depuis n'importe où sur votre disque (littéralement n'importe quel chemin sur lequel NodeJS peut lancer un stat, un readdir et un readFile). Vous pouvez même les organiser en dossiers virtuels (comme les alias d'Apache et les mounts d'Express).
Évidemment, vous pouvez modifier vos fichiers, pas seulement les consulter ! Les TiddlyWiki mono-fichier utilisent l'enregistreur PUT, qui a besoin d'être patché en utilisant un bookmarlet disponible sur la page d'accueil. Les instructions correspondantes sont disponibles juste sous le titre "One thing that needs to be noted".
Et vous pouvez évidemment modifier vos TiddlyWiki multi-fichiers comme si vous exécutiez node tiddlywiki.js data --server, sauf que vous l'exécutez depuis le chemin où vous l'avez ouvert (p.ex. http://localhost/personal/notes/). Vous pouvez avoir autant de dossier de données ouverts que vous voulez, ils n'entrent pas en conflit entre eux (même si chacun consomme de la mémoire).
Les dossiers de données stockent des tiddlers individuels, pas des wikis entiers. Ils occupent moins de place car ils ne contiennent ni le noyau ni les plugins. La conséquence est qu'ils s'enregistrent beaucoup plus rapidement, surtout à travers internet. Ils s'enregistrent aussi immédiatement (en 10s environ) et enregistrent aussi les brouillons.
NDT
TiddlyWiki mono-fichier
Il s'agit d'un wiki contenu dans un seul fichier HTML, comme le fichier empty.html que vous pouvez télécharger ici. Vous utilisez le wiki en ouvrant le fichier avec un navigateur.
TiddlyWiki multi-fichiers
Lorsqu'un wiki est hébergé sur Node.js, chaque tiddler est stocké dans son propre fichier .tid et ces fichiers sont organisés dans un dossier de données. Pour utiliser le wiki il faut saisir l'URL correspondante dans le navigateur. Plus d'informations ici.
The web server API uses tiddlers in a special format originally designed for TiddlyWeb:
Field values are represented as strings. Lists (like the tags and list fields) use double square brackets to quote values that contain spaces
Tiddlers are represented as an object containing any of a fixed set of standard fields, with custom fields being relegated to a special property called fields
The standard fields are: bag, created, creator, modified, modifier, permissions, recipe, revision, tags, text, title, type, uri
TiddlyWiki est un outil riche et interactif, capable de manipuler des données complexes dont la structure n'est pas adaptée aux outils conventionnels comme les traitements de texte ou les feuilles de calcul.
TiddlyWiki est conçu pour s'adapter à votre cerveau, en vous aidant à gérer ce qui s'adapte mal. L'idée fondamentale est que les informations sont plus utiles et plus facilement réutilisables quand on les découpe en morceaux sémantiques aussi petits que possible – les tiddlers – en leur donnant des titres à partir desquels le wiki pourra se structurer à l'aide de liens, d'étiquettes, de listes et de macros. Les tiddlers utilisent une notation WikiTexte qui permet de représenter de façon concise une grande panoplie de fonctions hypertexte et de formatage. Le but de TiddlyWiki est de fournir une interface de travail fluide, à même de faciliter l'agrégation des tiddlers et leur recomposition en textes plus long.
Les gens adorent utiliser TiddlyWiki. Comme on peut l'utiliser en l'absence d'infrastructure de serveurs compliquée, et qu'il est open source, il a apporté une liberté inédite à ceux qui veulent garder le contrôle de leurs précieuses informations.
TiddlyWiki a été créé initialement par JeremyRuston et est maintenant devenu un projet open source qui s'épanouit grâce à une communauté active de développeurs indépendants.
Bienvenue sur le site du TiddlyWiki Camp. Un évènement pour rencontrer la communauté de ce logiciel Open Source, libre et gratuit. Découvrez ce bloc note personnel polyvalent et adoptez-le pour gérer votre quotidien !
AndroidChromeEdgeFirefoxInternet ExploreriOSLinuxMacOperaPHPSafariEnregistrer les modificationsWindows
Initialement conçu par Jeremy Ruston et depuis maintenu par Arlen Beiler, TiddlyWiki Cloud (précédemment appelé TiddlyWiki in the Sky for Dropbox) est un service en ligne qui vous permet d'éditer vos documents TiddlyWiki directement dans votre Dropbox en utilisant juste un navigateur.
Il fonctionne avec TiddlyWiki5. En ce qui concerne TiddlyWikiClassic, le chargeur actuel ne fonctionne pas, mais un chargeur ultérieur pourrait fonctionner.
TiddlyWiki in the Sky pour TiddlyWeb permet la synchronisation du contenu entre le TiddlyWiki s'exécutant dans un navigateur et un serveur TiddlyWeb (ou TiddlySpace).
Welcome to the TiddlyWiki Marketplace. This new forum is designed to provide a space for individuals and organizations to offer commercial products and services that are built around TiddlyWiki:
Exécuter TiddlyWiki avec Node.js comporte plusieurs avantages par rapport à la version s'exécutant dans un seul fichier :
Vous pouvez éditer le contenu du wiki dans n'importe quel navigateur compatible HTML5, y compris s'il tourne sur des smartphones ou des tablettes
Les tiddlers sont stockés dans des fichiers séparés, que vous pouvez organiser comme vous le souhaitez
Vous avez la possibilité de construire plusieurs wikis différents à partir de contenu partagé entre eux ou spécifique à un seul wiki.
Notez que TiddlyWiki sur Node.js ne permet pas de modifier directement les fichiers de tiddlers sur le disque en dehors de TiddlyWiki tant qu'il est en cours de fonctionnement. Toute modification ne sera prise en compte qu'après un redémarrage du serveur. La méthode recommandée pour interagir avec un wiki actif est à travers l'API HTTP ou JavaScript.
Congratulations to vilc for their winning design for the banner for this release (here is the competition thread).
Overview of v5.3.1
This release comes only a few weeks after v5.3.0. The motivation for the release is to swiftly fix some issues that have emerged with v5.3.0. There are also some other improvements included in this release, notably the ability to access binary resources over HTTP – the demo downloads a random image or video of a dog.
This tutorial is aimed at giving you a basic foundation so that you can start using TiddlyWiki right away. Here we take a look at the technology behind Tiddlywiki, how to install it and create your first Tiddler.
A tiddlywiki.files JSON file in a sub-folder within a TiddlyWiki folder overrides the usual logic for recursively scanning the folder for tiddler files. Instead, the tiddlywiki.files file specifies instructions for loading tiddlers from specific files and folders.
The format of the file is an object with two optional properties:
tiddlers - an array of objects describing external files with the ability to override or modify any of the fields read from the file
directories - an array of objects describing external directories, a filter determining which files within those directories should be processed, and the ability to override or modify any of the fields read from the file
Note that significant enhancements to tiddlywiki.files processing were introduced in Release 5.1.14.
Field overrides
Both the tiddlers and directories sections of tiddlywiki.files files include the ability to override or customise the values of fields with a fields object.
Each field can be specified as either a string or array value to be assigned directly to the field, or Depuis : 5.1.14 an object describing how to generate the value for the field. The object contains the following properties:
source - (optional) a string specifying the source value for the field. If not specified, the existing value is used
filename the filename of the file containing the tiddler
filename-uri-decoded the filename of the file containing the tiddler, with URI decoding applied
basename the filename of the file containing the tiddler without any extension
basename-uri-decoded the filename of the file containing the tiddler without any extension, with URI decoding applied
extname the extension of the filename of the file containing the tiddler
created the creation date/time of the file containing the tiddler
modified the modification date/time of the file containing the tiddler
Depuis : 5.3.0filepath the path of the file containing the tiddler, relative to the path property of the directory (only usable in directories declarations)
Depuis : 5.3.0subdirectories an array of the subdirectories in the file's path relative, to the path property of the directory (only usable in directories declarations)
prefix - (optional) a string to be prepended to the value of the field
suffix - (optional) a string to be appended to the value of the field
Tiddlers section
The file specifications in the tiddlers array support the following properties:
file: (required) the absolute or relative path to the file containing the tiddler data (relative paths are interpreted relative to the path of the tiddlywiki.files file)
isTiddlerFile: (optional) if true, the file will be treated as a tiddler file and deserialised to extract the tiddlers. Otherwise, the raw content of the file is assigned to the text field without any parsing
fields: (optional) an object containing values that override or customise the fields provided in the tiddler file (see above)
prefix & suffix: (optional) strings to be prefixed and suffixed to the tiddler text field
Note that providing a prefix here is equivalent to setting the text field of the fields object to {"prefix":"<prefixvalue>"}.
Directories section
Directory specifications in the directories array may take the following forms:
a string literal, specifying the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the tiddlywiki.files file). The directory is recursively searched for tiddler files
Depuis : 5.1.14 an object with the following properties:
path - (required) the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the tiddlywiki.files file). Note that by default the directory is not recursively searched; sub-directories are ignored unless the searchSubdirectories flag is set to true (see below).
filesRegExp - (optional) a regular expression that matches the filenames of the files that should be processed within the directory
isTiddlerFile - (required) if true, the file will be treated as a tiddler file and deserialised to extract the tiddlers. Otherwise, the raw content of the file is assigned to the text field without any parsing
isEditableFile - Depuis : 5.1.23 (optional) if true, changes to the tiddler be saved back to the original file. The tiddler will be saved back to the original filepath as long as it does not generate a result from the $:/config/FileSystemPath filters, which will override the final filepath generated if a result is returned from a filter.
searchSubdirectories - Depuis : 5.1.23 (optional) if true, all subdirectories of the path are searched recursively for files that match the (optional) filesRegExp. If no filesRegExp is provided, all files in all subdirectories of the path are loaded. Tiddler titles generated via the source attribute filename (see above) will only include the filename, not any of the subdirectories of the path. If this results in multiple files with loaded with the same tiddler title, then only the last file loaded under that tiddler title will be in memory. In order to prevent this, you can use the filepath attribute instead of filename. Alternately, you can include multiple directory objects and customise the title field with a prefix or suffix alongside the source attribute.
fields - (required) an object containing values that override or customise the fields provided in the tiddler file (see above)
Fields can also be overridden for particular files by creating a file with the same name plus the suffix .meta – see TiddlerFiles.
Examples
These example tiddlywiki.files must be placed in their own sub-directory of the wiki folder.
This example retrieves all the files with the extension .pdf from a folder specified by a relative path. This path starts with "../../../" indicating 3 directory levels above the folder holding this config file. Each tiddler is set up for LazyLoading with the following fields:
title - set to the URI decoded base filename of the PDF file. URI decoding allows characters like "/" to be included in titles by URI encoding them as "%2F"
created - set to the creation date/time of the PDF file
modified - set to the modification date/time of the PDF file
type - set to application/pdf
tags - set to $:/tags/AttachedFile
text - set to an empty string
_canonical_uri - set to the string "pdfs/" concatenated with the filename
This example retrieves all the files with the extension .txt from a folder specified by a relative path. This folder is within the wiki's base directory, and the current config file is in a directory within the wiki's "tiddlers/" directory. So, in this case the path starts with "../../" to traverse upwards two directory levels, and then down into the "externalnotes/" directory. Each tiddler is set up with the following fields:
title - set to the URI decoded base filename of the text file. URI decoding allows characters like "/" to be included in titles by URI encoding them as "%2F"
created - set to the creation date/time of the text file
modified - set to the modification date/time of the text file
type - set to text/plain
tags - set to [[note]] [[externalnote]] [[.txt]] (using array notation)
text - not set, thus the content of the file is loaded as the text field
This will load all text files in the ../../externalnotes/ directory into the wiki as individual tiddlers. These can be a collection of snippets in various markup-languages. Then, the type field of each of these tiddlers can be changed to match their languages For example, "text/vnd.tiddlywiki" for wikitext, or "text/markdown" for markdown files. Then, using $:/config/FileSystemPaths and $:/config/FileSystemExtentions tiddlers with the following lines we can cause any changes to these tiddlers to be saved back to the directory they started from, and also as "*.txt" files with accompanying "*.txt.meta" files. These meta files will be generated as required, and will then over-ride any fields generated from the config tiddlywiki.files file (such as the tiddler's type field) when the server is restarted.
From the examples in Customising Tiddler File Naming we see that the final [!tag[externalnote]addprefix[wiki/]] filter in the $:/config/FileSystemPaths tiddler excludes all tiddlers tagged with externalnotes (that have not matched an earlier filter). These tiddlers have their filepath retrieved from the $:/config/OriginalTiddlerPaths generated upon boot startup.
Then, the [tag[.txt]then[.txt]] filter in the $:/config/FileSystemExtensions tiddler forces all these tiddlers to be saved back to disk as *.txt and accompanying *.txt.meta files (overriding the normal tiddler-type to file-type mapping). In this case, allowing the snippets of Tiddlywiki wikitext or markdown-text to be saved back to "text" *.txt files.
Importing and auto-tagging images
This example imports all the image files in the files directory and all its subdirectories as external-image tiddlers, and tags them based on their filepath. Each tiddler is set up with the following fields:
title - set to the URI decoded base filename of the text file
created - set to the creation date/time of the text file
modified - set to the modification date/time of the text file
type - set to image/jpeg. There is currently no way to infer the correct ContentType of the image tiddler from the file, but image/jpeg tiddlers should render correctly even with png or gif images. As an alternative, you could create separate definitions for jpg, png, and gif files with the image/jpeg, image/png, and image/gif types respectively.
tags - generated based on the path of the image relative to the parent directory (files in this case). Eg, images in files/photos will be tagged with photos, those in files/photos/family will be tagged with both photos and family, and those in the root files directory will have no tags.
text - set to an empty string
_canonical_uri - set to the full filepath of the image relative to the wiki root
TiddlyWikiFolders are configured with a single tiddlywiki.info file in the root of the wiki folder. It should contain a JSON object comprising the following properties:
plugins - an array of plugin names to be included in the wiki
themes - an array of theme names to be included in the wiki
languages - an array of language names to be included in the wiki
includeWikis - an array of references to external wiki folders to be included in the wiki
build - a hashmap of named build targets, each defined by an array of command tokens (see BuildCommand)
config - an optional hashmap of configuration options (see below)
includeWikis
The entries in the includeWikis array can be either a string specifying the relative path to the wiki, or an object with the following fields:
path - relative path to wiki folder
read-only - set true to prevent the tiddlers in the included wiki from being modified. The modifications will be written to the directory specified in default-tiddler-location, described below
build
Note that the build targets of included wikis are merged if a target of that name isn't defined in the current tiddlywiki.info file.
config
Configuration options include:
default-tiddler-location - a string path to the default location for the filesystem adaptor to save new tiddlers (resolved relative to the wiki folder)
retain-original-tiddler-path - If true, the server will generate a tiddler $:/config/OriginalTiddlerPaths containing the original file paths of each tiddler in the wiki
TiddlyWiki5 est une réincarnation de TiddlyWiki armée pour les 25 prochaines années. Il s'agit d'une wiki interactif complet, écrit en JavaScript et qui peut s'exécuter soit dans un navigateur web, soit en mode serveur sous Node.js.
Étant donné un numéro de version MAJOR.MINOR.PATCH. Incrémenter le :
MAJOR, quand vos modifications rendent l'API incompatible,
MINOR, quand l'ajout des fonctionnalités respecte la compatibilité,
PATCH, lorsque vos modifications compatibles corrigent des bogues.
Pour les pré-versions et l'ajout de métadonnées, des extensions disponibles peuvent s'ajouter au numéro de version MAJOR.MINOR.PATCH.
Versions Alpha et Beta
Quand TiddlyWiki5 était en version alpha, il utilisait l'extension de pre-version "alpha", par exemple :
5.0.1-alpha
Chaque nouvelle version alpha ou bêta impactera le numéro de version PATCH.
C'est une rupture par rapport au strict respect du standard car l'incrément des PATCH est supposé réservé aux modifications compatibles.
Noter que lors des versions précédant la 5.0.1-alpha, TiddlyWiki5 utilisait des n° de version formulés ainsi 5.0.0-alpha.19. Le changement fut effectué pour permettre au processus de mise à jour d'identifier l'évolution des plugins à partir de l'information donnée par le n° de version.
Versions intermédiaires
En phase de développement, quand une nouvelle version est proposée, l'extension de préversion lui est ajoutée.
Version des Plugin
Numéro de Version
TiddlyWiki5 utilise le n° de version lié aux plugins pour déterminer quel est le plus récent au moment de la phase de mise à jour ou d'import. L'extension pre-release est ignoré quand les comparaisons sont effectuées.
Les fichiers TiddlyWiki HTML contiennent une collection de tiddlers encodés au format <DIV>.
Pour qu'un fichier HTML soit importable comme un fichier TW non crypté, il faut au minimum qu'il contienne un <div id="storeArea"> juste avant les DIVs des tiddlers, eux-mêmes suivis immédiatement par un </div>. Par exemple :
<div id="storeArea">
<div created="20130302085406905" modified="20130302084548184" tags="Exemples" title="Un titre de tiddler">
<pre>Texte d'un tiddler encodé en HTML
</pre>
</div>
<div created="20140315085406905" modified="20140321084548184" tags="Un Deux [[Trois avec espace]]" title="Un autre titre" champperso="valeur du champ">
<pre>Texte de ce tiddler
</pre>
</div>
En plus des wikis contenus dans un seul fichier, TiddlyWiki on Node.js reconnaît les wikis conservés dans un dossier contenant un fichier pour chaque tiddler.
Fichiers et répertoires dans les dossiers TiddlyWiki
Les dossiers TiddlyWiki peuvent contenir les fichiers et répertoires ci-dessous :
tiddlywiki.info — fichier JSON contenant les métadonnées du wiki
\tiddlers — répertoire contenant les fichiers de tiddlers constituant le wiki
\plugins — répertoire contenant les dossiers de plugins à inclure dans le wiki.
Seul le fichier tiddlywiki.info est obligatoire, les dossiers tiddlers et plugins étant optionnels. Les autres fichiers et dossiers éventuellement présents à la racine d'un dossier TiddlyWiki sont ignorés.
Contenu du fichier tiddlywiki.info
Le fichier tiddlywiki.info présent dans un dossier wiki contient un objet JSON contenant les champs suivants :
plugins - un tableau de noms de plugins à inclure dans le wiki
themes - un tableau de noms de thèmes à inclure dans le wiki
languages - un tableau de noms de langues à inclure dans le wiki
includeWikis - un tableau de chemins relatifs vers des dossiers wikis externes à inclure dans le wiki
build - une table de hachage de noms de cibles de compilation, chacune étant définie par un tableau de jetons de commande (voir BuildCommand)
config - une table de hachage optionnelle d'options de configuration (voir ci-dessous)
includeWikis
Les entrées du tableau includeWikis peuvent être soit une chaîne indiquant le chemin relatif vers le wiki à inclure, soit un object contenant les champs suivants :
path - chemin relatif vers le répertoire du wiki
read-only - donner une valeur true pour éviter que les tiddlers du wiki inclus soient modifiés. Les modifications seront écrites dans le répertoire spécifié dans l'option de configuration default-tiddler-location, décrite ci-dessous.
build
Notez que les cibles de compilation des wikis à inclure sont fusionnées si aucune cible du même nom n'est définie dans le fichier tiddlywiki.info courant.
config
Les options de configuration comprennent :
default-tiddler-location — une chaîne de caractères indiquant le chemin vers la localisation par défaut de l'adaptateur système de fichiers utilisé pour enregistrer de nouveaux tiddlers (le chemin est résolu relativement au dossier wiki)
retain-original-tiddler-path — si la valeur est à true, le serveur génèrera un tiddler $:/config/OriginalTiddlerPaths contenant les chemins de fichiers d'origine de chaque tiddler dans le wiki.
Tous les fichiers de tiddler présents dans le dossier tiddlers et ses sous-dossiers sont interprétés dans le wiki au démarrage. Les éventuels sous-dossiers sont explorés récursivement.
Les sous-dossiers contenus dans le dossier tiddlers peuvent également contenir un fichier JSON nommé tiddlywiki.files qui modifiera le traitement par défaut de ce dossier. Le format de ce fichier est illustré par cet exemple tiré du plugin D3 :
Les données JSON consistent en un objet ayant une propriété tiddlers qui contient un tableau d'informations sur chaque tiddler à charger dans le wiki. Cette information est constituée de :
file: le chemin de fichier relatif ou absolu du fichier de tiddler à inclure
fields: un objet contenant des champs qui surchargent ceux éventuellement fournis dans le fichier de tiddler
prefix & suffix (optionnels) : chaînes de caractères à utiliser pour préfixer et suffixer le contenu texte du fichier de tiddler.
The timeline macro returns a list of tiddlers in reverse chronological order of modification (or some other date field), grouped by day.
Parameters
limit
The maximum number of tiddlers to include, defaulting to 100. But if any tiddlers are included for a particular day, all of the other tiddlers for that day will also be included – even if this exceeds the limit
format
A string specifying the desired format, defaulting to DDth MMM YYYY
The content or description and data of events are stored in individual tiddlers.
Timelines contain two timeline macros and two sequence macros. A sequence macro shows event contents in sequence not necessarily in chronological order. The order can be determined by tag or list field or other methods.
ChromeEdgeFirefoxLinuxMacOperaOther ResourcespluginsEnregistrer les modificationsWindows
Timimi est une web-extension accompagnée d'un hôte natif qui permet d'enregistrer et sauvegarder vos TiddlyWiki mono-fichier HTML n'importe-où sur votre disque. Une fois installée, vous pouvez enregistrer les fichiers TiddlyWiki sans autre formalité, comme le plugin original Tiddlyfox.
This is a Control Panel extension that aims to simplify the plugin creation and editing process. After installing, you will find a new tab in your control panel that makes creating and modifying plugins a little bit easier.
Le tiret est un signe de ponctuation. Il ne doit pas être confondu avec le trait d’union et le signe moins. Il existe trois types de tirets, en fonction de leur longueur : le tiret court, le tiret moyen et le tiret long.
[title[An Example]] can be shortened to [[An Example]], because title is the default filter operator. Consequentially, [!title[An Example]] can be shortened to [![An Example]].
This operator does not change anything except the first letter of each word, so [[aBcD eFgH]] would become [[ABcD EFgH]]. If you want [[Abcd Efgh]], then use a filter like [lowercase[]titlecase[]].
With Todolist, easily organise and prioritise your tasks and projects so you’ll always know exactly what to work on next.
Todolist creates custom UI and lets you to add new items, set priority, done/undone items, archive, delete. Using Todolist plugin it is possible to create several todo lists in one Tiddlywiki.
The toggle operator requires at least one parameter and can accept additional optional parameters. With a second optional parameter it can be used to toggle between a pair of titles:
[toggle[<title1>],[<title2>]]
title1 : a title to toggle in the input list. If it is already present, it is removed. Otherwise, it is added.
title2: (optional). When the second parameter is provided, the operator toggles between the two values in the input list. If neither is present, the first parameter takes precedence is added to the list.
With more than two parameters, the toggle behaves similar to the cycle and can be used to cycle through a list of values. Note that all operands should be unique.
While the cycle operator interprets its first parameter as a list of titles to cycle through and offers similar functionality, the toggle operator accepts an unlimited number of distinct parameters.
Titre optionnel d'un sous-tiddler quand le tiddler cible est un plugin (voir infra)
mode
Force le mode d'analyse du texte transclus à "block" ou à "inline" (voir infra)
Le Widget Transclude traite son propre contenu comme cible par défaut si la cible de transclusion n'est pas complètement définie (ex : un tiddler ou un champ manquant)
le mode « en ligne » (inline) reconnaît les formats de caractères, tels que l'emphase, les liens
le mode « bloc » (block) reconnaît tous les formats en ligne, et ajoute les formats de blocs comme les tableaux, les listes et les titres
Habituellement, le mode bloc ou en ligne est déduit automatiquement du mode dans lequel le Widget Transclude lui-même a été analysé. Il peut toutefois être ajusté avec l'attribut mode.
Par exemple, considérons un tiddler « A » avec ce contenu :
# Article un
#<$transclude tiddler="B"/>
# Article deux
Et un tiddler « B » avec ce contenu :
# Article un - a
# Article un - b
Le résultat donnera quelque chose comme :
Article un
# Article un - a # Article un - b
Article deux
Cela peut être corrigé en modifiant le tiddler « A » :
# Article un
#<$transclude tiddler="B" mode="block"/>
# Article deux
La Transclusion est le procédé de référencement d'un tiddler "A" à partir d'un autre tiddler "B" de sorte que le contenu de "A" apparait être une partie de "B".
Copier / coller du contenu crée des copies multiples d'un même contenu en différents endroits. Avec la transclusion, il peut y avoir une seule copie et une instruction spéciale dans "B" qui mentionne le point à partir duquel doit être inséré le contenu du tiddler "A".
Notez que si le contenu de "A" est modifié, alors la modification apparait immédiatement dans "B". Cela rend aisé la maintenance de contenu répétitif, en permettant l'écriture d'éléments à un seul endroit, mais l'affichage en de multiple lieux.
Le concept de transclusion joue un rôle important dans la Philosophie des Tiddlers car c'est la première façon de combiner le contenu de petits articles.
La puissance du WikiTexte vient de sa capacité à utiliser le contenu d'un tiddler dans un autre. Cette capacité prend plusieurs formes qu'on peut facilement confondre.
La principale différence réside entre la transclusion et la substitution de texte :
Une transclusion est remplacée dynamiquement avec l'une ou l'autre de ces valeurs :
un champ de tiddler
une variable
Une substitution de texte est réalisée dans le texte de la définition de la macro avant son utilisation.
Comme décrit dans HTML dans le WikiTexte, vous pouvez aussi transclure des valeurs de champs de tiddlers dans des attributs de balises HTML et de widgets. Par exemple :
<$text text={{MonTiddler}}/>
Comme décrit dans Introduction à la rédaction d'un filtre, vous pouvez aussi transclure des valeurs de champs de tiddlers dans des opérandes de filtres. Par exemple :
{{{ [tag{TiddlerContenantMonTag}] }}}
Transclusion de variable/macro
Les définitions de variables qui comportent des paramètres ou des substitutions sont nommées des « macros ». Vous pouvez transclure la valeur d'une variable/macro grâce à la syntaxe :
<<maMacro param:"Valeur d'attribut">>
Comme décrit dans HTML dans le WikiTexte, vous pouvez aussi transclure des valeurs de variables dans des attributs de balises HTML et de widgets. Par exemple :
<$text text=<<myMacro>>/>
Comme décrit dans Introduction à la rédaction d'un filtre, vous pouvez aussi transclure des valeurs de variables dans des opérandes de filtres. Par exemple :
{{{ [tag<maMacro>] }}}
Substitution de texte
La substitution de texte a lieu quand la valeur d'une macro/variable est utilisée. Ce mécanisme est décrit dans Macros en WikiTexte.
La différence principale entre la substitution et la transclusion est que la substitution a lieu avant l'analyse du WikiTexte, ce qui signifie que vous pouvez utiliser la substitution pour construire des assemblages de WikiTexte. Au contraire, les transclusions sont traitées indépendamment et ne peuvent pas être combinées avec du texte adjacent pour construire des assemblages de WikiTexte.
Pour inclure le contenu d'un TiddlerA dans un TiddlerB, modifier le précédent pour y inclure le texte suivant :
Voici le contenu de TiddlerA: {{TiddlerA}}
Le résultat permet au contenu du champ text (c.à.d le contenu principal) du TiddlerA de s'afficher dans le TiddlerB.
Utilisation
La notation {{TiddlerA}} est une abréviation de {{TiddlerA!!text}}, puisque le champ de transclusion par défaut est text, mais tout autre champ peut être spécifié. Par exemple, vous pouvez visualiser la dernière fois que le TiddlerA fut modifié par :
TiddlerA a été modifié le {{TiddlerA!!modified}}
En omettant le titre du tiddler, la notation de transclusion peut aussi être utilisé pour afficher le contenu d'un champ du tiddler en cours, par exemple :
Le tiddler en cours a été modifié le {{!!modified}}
Erreurs Récursives
Notez que l'utilisation de {{!!text}} ou {{}} engendre le message d'erreur (Erreur dans le widget transclude : transclusion récursive), car il n'y a aucun sens à inclure le contenu du tiddler courant dans le contenu du tiddler courant (c.à.d, en lui-même). Chaque fois que vous rencontrez ce message d'erreur, cela voudra dire que vous essayez d'inclure quelque chose en lui-même, directement ou indirectement (par exemple si le tiddler A transclut le tiddler B qui transclut le tiddler C qui, à son tour, transclut le tiddler A).
En savoir plus
Dans TiddlyWiki, les transclusions ne sont pas limitées à l'inclusion de contenu brut comme ci-dessus. Pour en apprendre plus au sujet de modes d'utilisation plus poussées, voir Transclusion par Gabarits.
La syntaxe de transclusion en WikiTexte génère un TiddlerWidget enveloppé dans un Widget Transclude. Par exemple, {{MonTiddler||MonGabarit!!monChamp}} génère cette paire de widgets :
Dans Transclusion, utilisation basique nous avons découvert comment inclure le contenu d'un tiddler A dans un tiddler B. Alors, supposons que le tiddler A contienne :
@@background-color:yellow;
Salut, mon titre est {{!!title}}
@@
Ceci fait afficher au tiddler A son titre sur fond jaune (voir Les styles et les classes avec WikiText pour les styles CSS). Imaginez que vous vouliez afficher le titre du tiddler B de la même façon. Mais que vous ne souhaitiez pas copier/coller les instructions de style, car vous désirez changer la couleur du fond plus tard et que vous vioulez maintenir une cohérence entre les tiddlers. Cela ressemble à un cas typique de transclusion, aussi essayons de transclure le tiddler A en tiddler B par la voie classique par {{A}}. Vous verriez alors le contenu suivant dans le tiddler B :
Salut, mon fr-titre est Transclusion par gabarits
Le stype est appliqué comme attendu, mais le titre est faux : nous voulons que {{!!title}} se réfère au tiddler B, cible, et pas au tiddler A, source.
La solution est dans l'utilisation d'un gabarit. Dans ce cas, le tiddler A, source, est appelé le Tiddler Gabarit, et est appliqué au tiddler B par l'utilisation de la notation {{||A}}. La différence est que toute Référence texte qui ne se réfère pas explicitement à un tiddler spécifique est affectée au tiddler courant, qui est, le tiddler cible. En conséquence, le tiddler B a maintenant l'aspect attendu :
Salut, mon titre est B
Utilisation
La Transclusion par gabarit est comparable à un masque : en supposant que le tiddler source contienne les références génériques (comme les trous des yeux dans un masque), celles-ci seront remplacées par les valeurs des tiddlers cible (comme les yeux d'une personne qui porte le masque).
Un gabarit peut être appliqué à tout tiddler, pas seulement au tiddler en cours, en utilisant la notation complète {{<cible>||<gabarit>}}. La <cible> par défaut est le tiddler courant (qui a été utilisé dans l'exemple supra).
Exemples
Un gabarit prédéfini pour un bel affichage des tags
Vous pouvez appliquer le gabarit système $:/core/ui/TagTemplate à un tag pour lui donner le style d'une pilule avec menu déroulant :
The translation mechanism of TiddlyWiki manages and switches between language plugins that provide translations of the TiddlyWiki user interface. The developer site at https://tiddlywiki.com/dev/ explains how translators can create and submit translations for TiddlyWiki.
The title of the current language plugin is read from the tiddler $:/language. If the selected plugin changes then any displayed translatable text automatically changes.
Translation plugins are bundles of tiddlers that each contain an independent translatable string. The strings are transcluded as needed.
Translatable strings are generally in the namespace $:/language/, for example:
The trash (also known as the Recycle Bin in Microsoft Windows) is a temporary storage for tiddlers that have been deleted in a Tiddlywiki by the user, but not yet permanently erased.
Typically, a trash bin is presented as a special storage, allowing the user to browse deleted (removed) tiddlers, undelete those that were deleted by mistake, or delete them permanently (either one by one, or by the "Empty Trash" function).
Triggering widgets are a type of widget which can trigger ActionWidgets. Typically these widgets (such as the ButtonWidget) will trigger actions based on interaction from the user.
TriTarget.org is a name I came up with in high school. I was big into computer programming and wanted a company name that was kinda catchy. When I made a few programs in BASIC I would brand them with TriTarget as a way to show off my company (Even though I didn't have one).
This instruction is based on Tiddlywiki single html file model, while it can use subfolder for extra materials like images, audios, videos, pdfs,... in separate folders.
This instruction is based on local edit, save and push to GitHub. It does NOT use the new GitHub Saver mechanism (requires TW 5.1.20+) which lets edit and save directly from Tiddlywiki!
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
This tutorial is aimed at giving you a basic foundation so that you can start using TiddlyWiki right away. Here we take a look at the technology behind Tiddlywiki, how to install it and create your first Tiddler.
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
This wiki gives examples for various filters and their use in the list widget. A good starting point to understand what filters yield which results also is test-filters.js.
Un manuel d'utilisation de TiddlyWiki (en Français) sur BiblioBox, une des variations de la PirateBox, système mobile de transfert et partage de fichiers.
J'ai connu TiddlyWiki à ses débuts en 2004. Je l'utilisais régulièrement comme bloc-notes de façon personnelle ou professionnelle en 2007 et 2012. Mais j'admets avoir ignoré cet outil pendant les deux dernières années. Et voilà que je me suis dit hier : mais pourquoi ne pas mettre TiddlyWiki sur une BiblioBox ? puisque c'est un simple fichier HTML avec du javascript. De plus je connaissais l'existence d'une version serveur pour sauvegarder les modifications en ligne.
Tiddlywiki software is prodigious based on javascript which is capable of holding a notepad that can be edited with Internet Explorer or function as a full blog, contained in a single file.
I never used Node.js until a couple weeks ago when I wanted to try a TW5 installation on Node and expand my knowledge a bit. I figured someone else may be in the same boat so I wrote it all down
Keeping a journal about your baby is fun. It allows you to keep track of those events in your baby's life and development that are most important to you, and to tell them in your own words. [...]
There are plenty of online services that can help to keep such a diary, but you need to have an internet connection to access them, and you have to trust them to keep your data safe.
I’ve been using TiddlyWiki for this game mainly to record the monsters’ locations and the items that they drop. This is so that when I need a certain item to upgrade/create weapons, I can quickly look it up; which monsters drop it and which quests have those monsters.
As I play the game, as I encounter new information, I just input them into my Shining Ark TiddlyWiki. It’s like I’m building a wiki from scratch. The reason why I don’t just use online wikis is that 1) it’s too easy to get spoiled and 2) sometimes online wikis provide too much information (who cares about the non-gameplay related descriptions that can be found in the game, etc).
Configuration VariablesVariables du noyauVariables
The tv-adjust-heading-level variable allows the level of headings to be adjusted. It is interpreted as a positive or negative number (e.g. "2" or "-3") that is added to the heading level for display.
Note that if the resulting heading level is less than 1 then level 1 is used instead. This means that specfiying a large negative adjustment factor will reset all headings to display as level 1. Similarly, heading levels larger than 6 are clamped to the maximum HTML heading level of 6.
! This is a Level 1 Heading
This is a paragraph.
<$vars tv-adjust-heading-level="-2">
{{Sample Headings 3,4,5}}
</$vars>
!! This is a Level 2 heading
<$vars tv-adjust-heading-level="-1">
{{Sample Headings 4,5,6}}
</$vars>
Sample Headings 3,4,5
!!! This is written as a Level 3 heading
!!!! This is written as a Level 4 heading
!!!!! This is written as a Level 5 heading
Sample Headings 4,5,6
!!!! This is written as a Level 4 heading
!!!!! This is written as a Level 5 heading
!!!!!! This is written as a Level 6 heading
Configuration VariablesVariables du noyauVariables
The tv-auto-open-on-import variable controls whether the tm-import-tiddlers message causes the tiddler $:/Import (which lists the pending imports) to open in the story river.
By default, the tiddler is opened. But if this variable has the value no, it isn't.
An example of setting this variable to no can be found in the upgrade plugin within the TiddlyWiki Upgrade Wizard. People can drag their wiki files onto the wizard without triggering the normal import display.
Configuration VariablesVariables du noyauVariables
The tv-config-toolbar-icons variable controls whether toolbar buttons display icons.
It can be set to yes or no prior to transcluding such a button.
The standard page template sets it to the value found in $:/config/Toolbar/Icons, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the Paramétrage tab of the Control Panel.
Configuration VariablesVariables du noyauVariables
The tv-config-toolbar-text variable controls whether toolbar buttons display text.
It can be set to yes or no prior to transcluding such a button.
The standard page template sets it to the value found in $:/config/Toolbar/Text, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the Paramétrage tab of the Control Panel.
Configuration VariablesVariables du noyauVariables
Depuis : 5.1.15 The tv-filter-export-link variable controls the value of the href attribute on the HTML a element generated by the $link widget. If defined, it takes precedence over the tv-wikilink-template Variable.
This variable has no useful effect when TiddlyWiki is running in a browser, as the href attribute is ignored there – links between tiddlers are performed by JavaScript instead. The variable comes into play when one is using the Node.js configuration to generate a static version of a wiki.
The variable is treated as a filter that is given the target tiddler title as input. The filter is evaluated and the first result is used as the href attribute.
Configuration VariablesVariables du noyauVariables
The tv-get-export-image-link variable controls the value of the src attribute on the HTML img element generated by the $image widget when the value of its source attribute is not the title of a tiddler.
The variable should be a macro with the following parameter:
src
The value of the source attribute – equivalent to the image name specified in the shorthand syntax[img[source]]
The ability to override image URIs in this way can be useful when one is using the Node.js configuration to export a static version of a wiki.
Configuration VariablesVariables du noyauVariables
The tv-get-export-link variable controls the value of the href attribute on the HTML a element generated by the $link widget.
This variable has no useful effect when TiddlyWiki is running in a browser, as the href attribute is ignored there – links between tiddlers are performed by JavaScript instead. The variable comes into play when one is using the Node.js configuration to generate a static version of a wiki.
The variable should be a macro with the following parameter:
to
The title of the target tiddler of the link, with no escaping
See also tv-wikilink-template. If both that variable and this one exist, this one dominates.
Configuration VariablesVariables du noyauVariables
The tv-wikilink-template variable controls the value of the href attribute on the HTML a element generated by the $link widget. The tv-filter-export-link, if defined, it takes precedence over the tv-wikilink-template variable.
This variable has no useful effect when TiddlyWiki is running in a browser, as the href attribute is ignored there – links between tiddlers are performed by JavaScript instead. The variable comes into play when one is using the Node.js configuration to generate a static version of a wiki.
The variable is treated as if it was a macro with the following parameters:
uri_encoded
The title of the target tiddler of the link, but percent-encoded
uri_doubleencoded
The value of the uri_encoded parameter but percent-encoded again, i.e. with its % characters further converted to %25
Configuration VariablesVariables du noyauVariables
The tv-wikilinks variable controls the behaviour of the $link widget.
The widget normally produces a link to a tiddler. But if this variable has the value no, the widget suppresses the link and simply displays the text that would otherwise have served as the link.
You can suppress links for a whole tiddler by placing the following line at the start of the tiddler's text:
\define tv-wikilinks() no
This variable has no effect on external links, as those do not involve the $link widget.
J'utilise TiddlyWiki5 avec Google Firebase depuis plus d'un an. C'est suffisamment stable pour l'utiliser au quotidien. Il y a un accompagnement détaillé sur la façon de créer sa propre instance avec de nombreuses captures d'écran. Le processus complet prend moins de 30 minutes : https://neumark.github.io/tw5-firebase/
Merci de considérer cette version comme une preuve de concept plus qu'un produit fini ! Je me suis concentré sur la collaboration multi-appareils ou en petites équipes :
Authentification de base (les sacs ont une politique d'accès qui détermine qui peut les lire ou les écrire).
De multiples wikis peuvent être hébergés avec le même compte Firebase.
Utilise l'authentification sociale intégrée à Firebase pour identifier les utilisateurs.
Les tiddlers sont verrouillés individuellement en écriture, pour éviter que les utilisateurs écrasent mutuellement leurs modifications.
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
This is Mat's, a.k.a <:-) little man-cave in the TiddlyVerse.
Most TW development is, understandably, based on the premise that "Improve code ➔ Better TW". TWaddle is also about developing TW but from the perspective that Bigger community ⇄ Better TW. Thus, TWaddle looks more to people issues - how to attract them, how to make them stick with TW etc.
I'm not a programmer but I am a TW enthusiast so I tiddlefiddle enough to make the occasional discovery of something cool. Given the amount of words I utter, it is also a mere numbers game before I say something that makes sense. TWaddle is intended to capture these eventualities.
The CommunitySearch wiki aggregates many public wikis from the community. It is updated automatically every day. At the time of writing, more than 5000 tiddlers are indexed, thus giving access to the largest known collection of TW content.
It lets you search for some specific content among a preselected list of wikis. The indexed content is mostly focused on TW usage, so you would typically use this search system to find information about a particular aspect of TiddlyWiki. Say for example that you want to learn how to make a table of content, type "table of content" in the CommunitySearch box (also accessible in the default tiddler GettingStarted). The search results are links to various wikis, and point directly to the specific tiddlers containing your request.
Fichier exécutable autonome, peut être déplacé, copié, etc.
Le wiki est compressé, il occupe moins d'espace disque (parfois même seulement un tiers de l'espace !)
Convertit n'importe quel fichier Tiddlywiki5 en fichier exécutable twexe, pas besoin de plugin pour TiddlyWiki
Utilise automatiquement l'onglet Sauvegarde du panneau de contrôle, où vous pouvez préciser un dossier pour les sauvegardes si celui par défaut ne vous plaît pas.
Récupérez facilement le fichier HTML du wiki à partir du twexe exécutable si vous en avez besoin
Ouvre la possibilité de lancer des exécutables externes à partir de votre wiki (pour dessiner des graphiques, etc.) - restez à l'écoute !
Reconnaît les images externes (c-à-d avec un champ _canonical_uri)
One of my favorite aspects of TiddlyWiki has been that it's web-based, making it possible for me to access my wiki from everywhere (especially my phone). That being said, I'm a bit paranoid, so I was left a bit unsatisfied with the tiddlywiki server's HTTP basic auth for protecting my wiki. ~23 commits later, I've created something called twproxy that I'd like to share with you all today, as I'm hoping somebody other than myself will find it useful.
Essentially it is a simple proxy that puts your wiki behind a username, password, and optional 2-factor auth prompt. This gives you added security in addition to the ability to remember your credentials past one browsing session (I was getting sick and tired of typing my username/password in over and over using basic auth).
Le WikiTexte peut inclure des blocs de texte qui seront interprétés selon le type de leur contenu, aussi appelé « type MIME ». Ces blocs sont déclarés ainsi :
Use the documentation macros to keep the text maintainable in the face of change.
Be wary of arbitrarily applying raw bold or italic markup in a sentence. If there's a suitable macro, use that instead. If there isn't a suitable macro, write one or request one.
Use simple backticks (`...`) for fragments of WikiText, but not for the names of things like fields and widgets. These have their own macros.
To keep things clean and simple, quotation marks and apostrophes should be straight ', not curly ’, and the ellipsis should be three separate dots ... rather than ….
Use " as the primary quotation mark, reserving ' for the rare case of a nested quotation.
Avoid using a single hyphen - as sentence punctuation. Instead, use a double hyphen – which TiddlyWiki renders as an en-dash – with a space on either side.
Items in lists and tables should only end with a full stop (period in US English) if they are complete sentences. They should have no trailing punctuation otherwise.
It is very rarely necessary to use an exclamation mark in professional documentation.
If you want to follow the steps side by side you can .
Follow these instructions when using TiddlyWiki as a standalone, single file wiki.
Create a backup of your current TiddlyWiki HTML file (just in case)
Open the and go to the Plugins tab
Click on the plugin you want to delete to open it as a standalone tiddler
Click the more button and delete the tiddler
Save your TiddlyWiki
If a yellow warning bar appears at the top of the window, refresh the window so that TiddlyWiki completely removes the plugin
Depuis : 5.1.22 It is no longer necessary to refresh TiddlyWiki when deleting plugins that support dynamic loading. See PluginMechanism for more details
The plugin should no longer be active or available
The unusedtitle macro returns an unused title. Optionally you can provide a base title to generate the new title.
It uses the same method as the create new tiddler button, a number is appended to the end of the base name.
Parameters
baseName
A string specifying the desired base name, defaulting to New Tiddler. The default setting can be adjusted in the $:/ControlPanel: Info : Basics - tab.
separator
Depuis : 5.2.0 An optional string specifying the separator between baseName and the unique number. eg: separator:"-". Defaults to a space: " ". If you need an empty separator use the template!
template
Depuis : 5.2.0 A optional template string can be used to allow you maximum flexibility. If the template string is used, there will always be a counter value.
Template String
$basename$
This variable will be replaced by the content of the baseName parameter
$separator$
This variable will be replaced by the separator parameter
$count$
This variable will be created automatically and is a counter starting with 0
$count:4$
This variable will be created automatically and starts at 0000
The following example works best if there is an open tiddler in draft mode, or there is a tiddler named "New Tiddler". So you can see the automatic numbering.
<<unusedtitle separator:"-">>
<<unusedtitle baseName:"anotherBase">>
<<unusedtitle baseName:"About" separator:"-">>
<<unusedtitle template:"$count:2$-test">>
Working buttons can be found at: unusedtitle Macro (Examples 1). You'll have to examine the code to see, what's going on.
De nouvelles versions de TiddlyWiki sont publiées régulièrement, avec des améliorations et des corrections de bogues. Il est recommandé de rester à jour en hissant votre wiki au niveau de la dernière version.
Introduction
La procédure décrite ici est réservée à la mise à niveau de fichiers TiddlyWiki autonomes. Pour mettre à niveau TiddlyWiki sur Node.js, il existe une méthode différente.
Il est de votre responsabilité de vous occuper de vos données ; prenez soin d'effectuer des sauvegardes, surtout quand vous mettez à niveau le noyau de TiddlyWiki.
Mise à niveau en ligne
Cette procédure fonctionnera sur la plupart des navigateurs de bureau. Notez que vos données personnelles ne quittent pas votre navigateur pendant la procédure.
Localisez votre fichier TiddlyWiki sur le système de fichiers (à l'aide de Windows Explorer, du Finder sur Mac OS X, ou de votre gestionnaire de fichiers sur Linux)
Faites glisser votre ancien fichier TiddlyWiki HTML sur la fenêtre du navigateur
Si le fichier est crypté, un mot de passe vous sera demandé
Passez en revue la liste des tiddlers qui seront mis à niveau
Cliquez sur Upgrade
Enregistrer les changements pour sauvegarder la nouvelle version
Cela aura pour résultat de télécharger sur votre ordinateur un fichier nommé upgrade.html. Ce fichier constitue la version à niveau de votre ancien fichier. Il se peut que vous deviez vous rendre là où upgrade.html a été téléchargé, renommer upgrade.html avec le nom de l'ancien fichier que vous mettez à niveau, et remplacer l'ancien fichier en déplaçant le nouveau à sa place.
Mise à niveau hors ligne
Vous pouvez également télécharger le fichier https://tiddlywiki.com/upgrade.html localement et effectuer la même procédure de glisser-déposer pour mettre vos fichiers à niveau.
Problèmes avec les mises à niveau
Il est possible qu'une personnalisation appliquée dans une version précédente devienne inopérante une fois la mise à niveau effectuée. Deux techniques peuvent être employées pour vous aider à retrouver l'origine du problème :
Essayez de répéter la mise à niveau en décochant tous les tiddlers qui pourraient contenir des personnalisations de TiddlyWiki
Utilisez le ModeSansÉchec pour désactiver toutes les adaptations personnalisées des tiddlers shadow
Vous pouvez voir quels tiddlers shadow ont été modifiés dans l'onglet Filtres de la recherche avancée. Choisir "Les tidders shadow modifiés" depuis le menu déroulant.
Si vous avez installé TiddlyWiki sur Node.js de manière standard, vous pouvez le mettre à jour dès qu'une nouvelle version est publiée, à l'aide de la commande suivante :
By default, when running TiddlyWiki on Node.js, the server exposes the wiki at the URI formed from the protocol, host and port - for example, http://127.0.0.1:8080/.
There are two steps to running the wiki at a custom path like http://127.0.0.1:8080/path/to/my/wiki/:
Configure the server by passing /path/to/my/wiki as the pathprefix argument of the ServerCommand
Configure the client by creating a tiddler called $:/config/tiddlyweb/host that contains $protocol$//$host$/path/to/my/wiki/
From the EditorToolbar you can export selected text to a new tiddler and insert a link, Transclusion or macro in its place. Click Excise text (), input name of the new tiddler, and choose excise method.
How to excise text
Highlight the relevant piece of text
Click Excise text ()
Give the new tiddler a title.
Choose if the new tiddler will be tagged with the title of the current tiddler (see note below).
Note! If you choose the option to Tag new tiddler with the title of this tiddler, the new tiddler will be tagged with the name of the current tiddler before it has been edited. If you have changed the title of the current tiddler, save it first and edit it again to perform excision with this option.
By default, TiddlyWiki's WebServer serves resources over the insecure HTTP protocol. The risk is minimal if it is only being used within a private, trusted network but in many situations it is desirable to use a secure HTTPS connection.
HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the tls-cert and tls-key parameters.
Depuis : 5.2.2 The optional tls-passphrase parameter allows the server to use certificate files that have been generated with a passphrase/password.
Certificates can be obtained from a certification authority such as https://letsencrypt.org/, or you can create a self-signed certificate for internal testing.
To create the required certificate files with the popular openssl utility:
Vous pouvez utiliser des liens (habituellement affichés en bleu)pour naviguer d'un tiddler à l'autre. Cliquer sur le lien vers un tiddler vous amène à ce tiddler. Si le tiddler est fermé, il sera ouvert. La particularité de TiddlyWiki est de rendre les liens vers tiddlers aussi accessible que possible. Il y a des liens partout ! Voici les principaux endroits où vous pourrez trouver des liens vers d'autres tiddlers dans TiddlyWiki :
Vous pouvez créer un lien vers un tiddler, qu'il existe déjà ou pas, dans le contenu de tout tiddler. Voir Liens avec WikiTexte pour consulter les différentes façons de créer simplement des liens entre tiddlers.
Chaque tag de votre tiddler (comme par exemple le tag Working with TiddlyWiki sous le titre de ce tiddler) contient un lien vers ce tiddler tag, ainsi que la liste de tous les tiddlers avec ce tag. Ce qui vous permet d'ouvrir un de ces tiddlers.
Le Panneau d'information de chaque tiddler vous donne l'accès à 4 onglets contenant un liste additionnelle de tiddlers connexes :
L'onglet Références liste tous les tiddlers avec un lien vers le tiddler en cours.
L'onglet Étiqueté liste tous les tiddlers tagués avec le titre du tiddler en cours.
L'onglet Liste liste tous les tiddlers (ou les tiddlers potentiels) mentionnés dans le champ liste du tiddler en cours.
L'onglet Listé liste tous les tiddlers qui mentionnent le tiddler en cours dans leurs champs liste.
Les onglets de la barre de menu contiennent plusieurs listes de liens vers des tiddlers :
L'onglet Récents liste les 100 tiddlers récemment modifiés, en commençant pas la modification la plus récente.
L'onglet Plus propose 8 listes supplémentaires de tiddlers :
Tout liste tous les tiddlers dans l'ordre alphabétique.
Tags liste tous les tags. Vous pouvez cliquer sur la pilule de tout tag pour accéder à la liste des tiddlers étiquetés par ce tag.
Manquants liste tous les tiddlers qui n'existent pas encore, mais auquels sont liés à d'autres tiddlers. Utile pour trouver les tiddlers que vous aviez prévu de créer, sans en avoir jamais eu le temps.
Ébauches liste tous les tiddlers actuellement en mode ébauche. TiddlyWiki considère l'ébauche d'un tiddler comme un tiddler séparé de l'original aussi longtemps que vous le modifiez, aussi, tant que vous modifierez le tiddler titré Australie, il y aura deux tiddlers, Australie et Draft of 'Australie'. Quand vous clôturerez l'ébauche en confirmant les modifications, ces modifications seront apportées au tiddler original Australie. Aussi, traitez l'onglet Ébauches comme un moyen de retrouver toutes les ébauches que vous avez commencé.
Orphelins liste tous les tiddlers non connectés à un autre tiddler par des lien, tag ou liste. C'est une assistance utile à l'organisation de vos fichiers - qui montre quels tiddlers doivent y faire l'objet d'une intégration plus soigneuse.
Types liste tous les tiddlers à contenu spécial, comme les images ou l'audio.
Résultats de la recherche est une liste des tiddlers contenant le texte que vous avez saisi dans la zone de recherche.
Enfin, vous pouvez créer vos propres tiddlers de listes personnalisées par différents moyens :
Vous pouvez transclure un filtre (voir Transclusion grâce à WikiText). Par exemple, l'ajout de {{{ [tag[montagne]] }}} à un tiddler insèrera une liste de tiddlers avec le tag montagne.
Vous pouvez utiliser le ListWidget. C'est plus compliqué que transclure un filtre, mais offre plus de souplesse dans l'affichage et la mise en forme d'une liste exactement de la façon dans laquelle vous désirez qu'elle s'affiche.
Snippets are pre-configured snippets of text which can be inserted into the editor by clicking the stamp () button on the toolbar and then on the required item.
Snippets can either replace, or be added before and/or after, the selected text in the editor.
Create a snippet
Whilst editing a tiddler
Click stamp () on the toolbar
Click "Add your own" at the bottom of the menu
Type the text for the snippet in the editor
Enter the caption for the snippet menu item in the caption field
Click the Confirm changes to this tiddler button
Manually
Create a new tiddler by clicking the Create a new tiddler button in the sidebar
Change the title for the tiddler (from e.g. New Tiddler 1). The tiddler title determines the menu item for the stamp if you do not set a caption field (see below).
Pro tip Set a title like $:/yourusername/snippets/My new stamp to 'file' your new tiddler away as a system tiddler which doesn't appear in the normal search results
Add the tag $:/tags/TextEditor/Snippet by entering $:/tags/TextEditor/Snippet in the tag name tag box and clicking Add (or pressing the Enter key)
Enter the snippet content (which you wish to appear in the editor when you click the stamp menu ) in the editor
Create a field with the name caption and value set to the text for the snippet's stamp menu item:
Enter caption in the Add new fieldfield name box
Enter the stamp menu item caption in the field value box
Re-ordering snippets
Your new snippet will appear at the bottom of the stamp menu by default. To adjust the order of snippets:
Navigate to a snippet tiddler
Click the $:/tags/TextEditor/Snippet tag pill
Drag items up and down the menu of snippets
Adding a prefix and/or suffix to a selection Depuis : 5.1.20
By default, the stamp button replaces text you have selected in the editor (let's say selectedText)with your snippet (let's say $:/my/snippet).
If instead of replacing selected text, you wish the stamp button to addwikitext before and/or after the selection:
Create a snippet tiddler (tagged $:/tags/TextEditor/Snippet, with caption field set to desired stamp menu item text) using either of the two methods above
Create a new tiddler with either /prefix or /suffix appended to the end of the snippet tiddler's title, according to whether you wish the stamp to insert the snippet content before (/prefix) or after (/suffix) the text selected in the editor.
Do not tag the tiddler $:/tags/TextEditor/Snippet; the caption field is ignored
Set the tiddler text to the text you wish to be inserted before or after your selection
Example configuration for snippet2 with prefix+suffix
Les premières étapes pour changer l'apparence de TiddlyWiki sont de choisir et d'appliquer un des thèmes disponibles, ou de modifier la palette de couleurs.
De plus, les feuilles de style CSS personnalisées peuvent être définies en taguant un tiddler par $:/tags/Stylesheet. Essayez de créer une feuille de style maintenant avec le contenu suivant pour modifier la couleur de fond de la page à rouge :
html body.tc-body {
background: red;
}
Outrepasser les réglages du thème
Les feuilles de style personnalisées sont appliquées indépendamment de celles du thème. Toutefois, il est souvent nécessaire aux règles css de votre feuille de style d'être plus spécifiques que celles du thème auquel vous désirez vous substituer. Ainsi, html body.tc-body sera plus pointu que body.tc-body.
Les types de feuille de style
Il est en général bien mieux de faire appel au text/css pour les feuilles de styles. Cela les interprète comme des feuilles de style à part entière, et assure que TiddlyWiki ne leur applique aucun processus wiki.
Si vous souhaitez utiliser macros et transclusions au sein de vos feuilles de style vous devrez y substituer le type WikiTexte par défaut text/vnd.tiddlywiki. Ce qui permettra a une interprétation WikiTexte d'être complètement appliquée. Voilà un exemple :
\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
body.tc-body pre {
<<box-shadow "inset 0 1px 0 #fff">>
}
Le pragma \rules au début du tiddler restreint l'application WikiTexte aux seules macros et transclusions. Sont ainsi évités les déclenchements de processus WikiTexte erronés indésirables.
Un tiddler feuille de style est interprété de façon telle qu'il est, dans un premier temps wikifié et la portion de texte en résultant est extraite pour être considéré comme du CSS. Toute balise HTML que vous utiliseriez dans votre feuille de style est ainsi ignorée. Par exemple, les éléments HTML générés par le RevealWidget n'affecteront pas le résultat en sortie. Comme dans l'exemple suivant, vous pouvez entourer les règles de balises <pre> pour les afficher comme des blocs de code sans affecter leur interprétation, incluant la prise en compte de la macro entourée.
\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
<pre>body.tc-body pre {
<<box-shadow "inset 0 1px 0 #fff">>
}
</pre>
TiddlyWiki5 allows you to use SVG to display vector graphics in two ways:
Tiddlers with the type image/svg+xml are interpreted as SVG images, and displayed and transcluded as self-contained <img> elements with the SVG embedded as a data URI in the src attribute.
The implications of the image being rendered within an <img> element are that it is sandboxed; it can't use CSS styles from the parent document, for example. Neither can the image use WikiText features like transclusion.
Embedding SVG elements
The other way to use SVG is to embed the <svg> element directly. For example:
Note that inline SVG elements don't need an <?xml version="1.0"?> directive.
You can include simple text strings in SVG images using the <text> element:
HTML or WikiText content can be included within inline SVG images using the <foreignObject> element. For example:
Transcluding SVG elements
When embedding SVG elements you can also use WikiText features like transclusion. For example, here is an SVG circle with the radius set to the value in the tiddler $:/SVGExampleRadius:
You can edit the value of the radius here:
Making curved text with SVG
Cette démonstration montre comment utiliser SVG pour faire suivre un chemin incurvé à un texte transclu. Entrez du texte dans la zone çi-dessous pour essayer ; visualiser le code source pour voir examiner le fonctionnement.
You can use a special template to externalise TiddlyWiki's core code into a separate file. This configuration allows the browser to cache the core for improved efficiency.
Background
TiddlyWiki in the single file configuration ordinarily packs everything into a single file: your data, and the JavaScript, CSS and HTML comprising TiddlyWiki itself. This lack of dependencies is usually very convenient: it means that it is impossible for the parts of a TiddlyWiki to become separated, and enormously improves the chances of it still functioning in the future.
However, there is some inefficiency in this arrangement because the core code is repeatedly loaded and saved every time the content of the wiki is saved. This inefficiency is partially ameliorated when working in the client server configuration because once the wiki is loaded by the browser the synchronisation process only transmits individual tiddlers back and forth to the server.
The remaining inefficiency when working in the client server configuration is that the single page wiki that is initially loaded will contain a copy of the entire core code of TiddlyWiki, making it impossible for the browser to cache it.
Using the external JavaScript template with the client-server configuration
The mechanism is activated by setting the root-tiddler parameter to $:/core/save/all-external-js. This template externalises TiddlyWiki's core JavaScript into a separate file. For example, the following command will start your server with caching enabled. It will transfer the wiki with two GET requests, and the core can be cached by the browser.
Using the external JavaScript template with the single file configuration
You can use the "external-js" template with your single file wiki, but this requires that you have TiddlyWiki's core JavaScript saved alongside your HTML file. You may prefer this configuration, for example, if you have several wikis on a WebDav server. (See: Saving via WebDAV)
This functionality is intended for advanced users: there are many more ways for things to go wrong than with the standard single file configuration
Saving your snapshots
If you start your TiddlyWiki server in the "external-js" configuration, snapshots you save from the wiki will also have the external-js configuration.
You can click on the "cloud" button and choose Save snapshot for offline use. The html wiki you saved will have a reduced file size compared to a regular snapshot because the TiddlyWiki core code has been externalised. However, to be able to use this wiki, you must also have a copy of TiddlyWiki's core JavaScript in the same directory; see below for instructions for obtaining it
The "server-external-js" edition lets you save the snapshot from the command line:
tiddlywiki YOUR_WIKI_FOLDER --build index
The files external-5-x-x.html and tiddlywikicore-5.x.x.js will be saved in your wiki folder's output directory.
Obtaining the TiddlyWiki core in the browser
For advanced users
Export the TiddlyWiki core JavaScript code for running with external JavaScript:
You can also run the following command to obtain the core JavaScript. The file tiddlywikicore-5.x.x.js will be saved in theoutput directory of your wiki folder:
Open your upgraded wiki in the browser. If you'd like to revert to using the regular template, restore the original shadow tiddler $:/config/SaveWikiButton/Template by deleting any custom copy. Save your wiki and you are done.
Otherwise, from your wiki, select the Tools tab from the sidebar and click on the export tiddlywiki core button to obtain the core from your wiki.
Verify that $:/config/SaveWikiButton/Template still contains $:/core/save/offline-external-js. Modify if necessary.
Save your wiki again. Your wiki is now converted to using the external core.
TiddlyWiki's experimental single tiddler per page, read-only view uses a simplified page layout, and implements links between tiddlers, but there are no other interactive features. Compared to a full TiddlyWiki user interface, it is very lightweight and usable even over very slow connections.
Alongside serving the full interactive wiki at the path / (e.g. http://127.0.0.1:8080/), TiddlyWiki serves each tiddler at the path /<url-encoded-tiddler-title>. For example:
Ordinary, non-system tiddlers are rendered through a special view template while system tiddlers are rendered through a template that returns the raw text of the rendered output. In this way ordinary tiddlers can be browsed by end users while system tiddlers can be included in their raw form to use them as JS, HTML or CSS templates. Additionally these defaults can be overwritten on a per tiddler basis by specifying the _render_type and _render_template fields accordingly.
TiddlyWiki5 can be used to produce documentation for GitHub projects. It lets you maintain a single set of documentation as a TiddlyWikiFolder containing separate tiddler files under source code control, and then use it to produce readme.md files for inclusion in project folders, or HTML files for storage in GitHub Pages. Both features are demonstrated by TiddlyWiki5 itself.
Generating readme.md files
When displaying the contents of a folder GitHub will look for a readme.md file and display it. Note that it will not display full HTML files in this way, just static MarkDown files (this is a security measure). Happily MarkDown permits a safe subset of HTML, and thus to generate a readme.md file that is suitable for GitHub it is just necessary for TiddlyWiki5 to generate the content of the <body> element of an HTML document, and give it the appropriate filename.
This is done with this command:
--rendertiddler ReadMe ./readme.md text/html
It saves the tiddler ReadMe to the file ./readme.md in the text/html format.
By default, tiddler links will be rendered as <a> links to a relative URI consisting of the title of the tiddler. This behaviour can be overridden by defining the macro tv-wikilink-template, as is done at the top of the tiddler ReadMe:
L'exécution du programme tiddlywiki depuis la ligne de commande démarre le noyau TiddlyWiki, charge les plugins de base et met en place une structure de wiki vide. Puis les arguments de la ligne de commande sont traités à la suite, de gauche à droite. Les arguments sont séparés par des espaces.
Le premier argument est un chemin optionnel vers le dossier à charger. Si absent, le répertoire courant est utilisé.
Suivent les commandes proprement dites, avec leurs arguments spécifiques, chaque commande étant annoncée par le préfixe --.
TiddlyWiki5 propose d'afficher les illustrations vectorielles SVG de deux façons :
Les Tiddlers avec le type image/svg+xml sont interprétés comme des images SVG, et affichés et transclus des éléments <img> autonomes avec du code SVG intégré (le lien URI vers les données source est dans l'attribut src)
WikiText peut aussi inclure directement des éléments SVG en ligne. Voir ci-dessous pour un exemple.
Intégration de tiddlers SVG
Vous pouvez intégrer un tiddler image SVG en utilisant la syntaxe ordinaire de transclusion :
{{Motovun Jack.jpg}}
De même, vous pouvez faire appel aux blocs typés pour intégrer un tiddler SVG en mode ligne.
Toutefois, le rendu de l'image par l'élément <img> fait qu'elle passe par un bac à sable, et ne peut pas récupérer les styles CSS du document parent, par exemple. L'image, en elle-même, ne peut pas utiliser de fonctionnalités WikiText comme la transclusion.
Intégration d'éléments SVG
L'autre façon d'utiliser SVG est d'intégrer des éléments <svg> directement. Par exemple :
Notez que les éléments SVG en mode ligne ne nécessitent pas de directive <?xml version="1.0"?>.
Inclure du contenu HTML ou WikiText dans des images SVG
Vous pouvez inclure de simples chaine de texte dans des images SVG par l'emploie de l'élément <text> :
Le contenu HTML or WikiText peut être inclu dans des images en mode ligne via l'élément <foreignObject>. Par exemple :
Transclusion d'éléments SVG
Lors de l'intégration d'éléments SVG vous pouvez faire appel à des fonctionnalités WikiText comme la transclusion. Par exemple, voici un cercle SVG dont la valeur du rayon est réglée dans le tiddler $:/SVGExampleRadius :
Vous pouvez modifier la valeur du rayon :
Tracer un texte incurvé avec SVG
Cette démonstration montre comment utiliser SVG pour faire suivre un chemin incurvé à un texte transclu. Entrez du texte dans la zone çi-dessous pour essayer ; visualiser le code source pour voir examiner le fonctionnement.
Variable attribute values are indicated with double angle brackets around a macro invocation. For example:
<div title=<<MyMacro "Brian">>>
...
</div>
The behaviour of variables invoked via widget attributes is not the same as when they are invoked via normal wikitext. In addition, the behaviour depends on how the variable is declared:
how declared
behaviour
\define
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the attribute's value
Body text is retrieved as-is and used as the attribute's value.
\function
When a function is invoked as <div class=<<macro>>/>, it is a synonym for <div class={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded. That first result is used as the attribute's value. Note that functions are recursively processed even when invoked in this form. In other words a filter expression in a function can invoke another function and the processing will continue
passed as normal javascript function parameter and so accessed as a normal javascript variable
Examples
These examples are meant to provide insight into the various ways of defining and using parameters. In many cases they do not illustrate best practices.
All wikitext and variable substitution takes place
\function
Invoking a function in this way (<<macro>>) is a synonym for <$text text={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded
Invoked via widget attribute: <div class=<<macro>>/>
how declared
behaviour
\define
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the attribute's value
Body text is retrieved as-is and used as the attribute's value.
\function
When a function is invoked as <div class=<<macro>>/>, it is a synonym for <div class={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded. That first result is used as the attribute's value. Note that functions are recursively processed even when invoked in this form. In other words a filter expression in a function can invoke another function and the processing will continue
Invoked via filter operator parameter: [<macro>]
how declared
behaviour
\define
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the filter operator's parameter.
Body text is retrieved as-is and used as the filter operator's parameter.
\function
The body text of the function is treated as a filter expression and evaluated. The first result is passed to the operator as a parameter. The remaining results are discarded.
Invoked via function call in a filter expression: [function[macro]]
Every function is a variable, but only variables defined using \function are invokable using the function filter operator. Attempts to use a non-function variable is the same as if the function doesn't exist. The behavior in this case is like the identity function. All filter input is passed unchanged to the output.
\function
The body text of the function is treated as a filter expression and evaluated. This filter expression can itself contain a function call. Filter expressions can be factored out into functions arbitrarily deep.
Examples
Below is an example macro, procedure and function definition. All three forms of parameter substitution $a1$, <<__a1__>>, and <<a1>> are included in each definition. The output helps illustrate when each form of substitution will or will not have affect.
"A free, open source wiki revisited" by Mark Gibbs, NetworkWorld
[function[p1],[foo]]
"A free, open source wiki revisited" by Mark Gibbs, NetworkWorld
[function[f1],[foo]]
$a1$ - - foo
Namespaces
tiddler titles - tiddlers are uniquely identified by their title. The namespace for tiddler titles and variable names are completely separate.
variables - \define, $set, $let, $vars, \procedure, \widget, \function all create variables. If the same name is used, then later define will overwrite earlier defined
function filter operator parameter - only variables defined using \function can be called using the function operator
filter operators - only the javascript defined filter operators and variables defined using \function with name containing a dot can be called
widgets - variables defined using \widget can be invoked using <$widget/> syntax ONLY if the name starts a dollar sign. Without the dollar sign prefix, defining variables using \widget is no different than using \procedure.
Une variable est une portion de texte accessible par son nom via une branche particulière de l'arbre widget. La portion reconnue est la valeur de la
variable.
Une nouvelle variable est définie par le widget $set, et ainsi accessible à tous les descendants du widget, incluant les contenus tranclus. Un widget $set peut utiliser un nom existant et relier ainsi, une portion différente à ce nom pour cette génération de descendants du widget.
Le widget $list affecte aussi une variable particulière (par défaut currentTiddler), tour à tour, à chaque titre listé.
Pour une vue d'ensemble quand à l'utilisation des variables, se reporter à variables dans Wikitexte .
Malgré le mot "variable", chaque portion contient une chaine constante. L'apparente variabilité est actuellement reflétée par la présence de plusieurs variables portant le même nom en différents endroits de l'arbre widget.
WikiTexte n'analyse pas les portions en elles-mêmes. Cependant la référence à une variable peut être transcluse dans un contexte où une analyse WikiText parsing may pourrait s'effectuer. Dans une portion de code, le seul marquage détecté est $name$ pour le paramètre de transclusion d'une macro et $(name)$ pour une variable à transclure.
La macro dumpvariables liste toutes les variables (y compris les macros) disponibles à une position donnée de l'arbre widget.
Pour transclure la valeur d'une variable, utilisez la syntaxe d'appel de macro sans paramètres. Vous pouvez aussi utiliser un widget $macrocall.
Le code de définition d'une macro peut contenir une ZoneRéservée$(nom)$ où la valeur d'une variable remplacera son nom.
La valeur d'une variable peut être utilisée comme paramètre de filtre, ou comme attribut de widget. Ce dernier cas prend en charge les paramètres de macro.
Exemple : définition d'une variable
<$set name=animal value=zèbre>
<<animal>>
</$set>
Exemple : définition d'une macro
Le pragma \define ci-dessous définit une macro nommée tags-of-current-tiddler. La macro renvoie la valeur du champ tags du tiddler, et peut être appelé partout dans le tiddler (ou dans tout tiddler qui l'importe).
\define tags-of-current-tiddler() {{!!tags}}
Les tags sont<<:>> <<tags-of-current-tiddler>>
Exemple : utilisation de variables comme paramètres de filtre
Cet exemple utilise l'opérateurbacklinks pour lister tous les tiddlers contenant des liens vers celui-ci.
The $vars widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible $set widget. It differs from the $let in that variables cannot interfere with the evaluation of other variables within the same $vars.
Content and Attributes
The content of the $vars widget is the scope for the value assigned to the variable.
Attribute
Description
{attributes not starting with $}
Each attribute name specifies a variable name. The attribute value is assigned to the variable
Attributes will not interfere with the evaluation of other attributes. So if one attribute sets currentTiddler, and another attribute uses currentTiddler in its evaluation, it will use the value of currentTiddler that exists outside the widget's scope.
Examples
Consider a case where you need to set multiple variables.
Using the $vars widget, this situation may be handled in the following way:
\define helloworld() Hello world!
<$vars greeting="Hi" me={{!!title}} sentence=<<helloworld>>>
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$vars>
In contrast, here is the same example using the $set widget:
<$set name="greeting" value="Hi" >
<$set name="me" value={{!!title}} >
<$set name="sentence" value=<<helloworld>> >
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$set>
</$set>
</$set>
Remarks
It should be noted that this widget differs from the $set widget in the following ways:
A fallback (also known as "emptyValue") cannot be specified
Filters cannot be used to produce a conditional variable assignment
The view template body cascade is a cascade used by the default view template to choose the template for displaying the tiddler body.
The default view template body cascade consists of:
If the tiddler title starts with any of a list of known system tiddler prefixes, use the template $:/core/ui/ViewTemplate/body/code to display the body as preformatted code
If the tiddler has the field plugin-type set to import then use the template $:/core/ui/ViewTemplate/body/import which displays the custom import user interface
You can see the current settings for the view template body cascade in $:/ControlPanel under the Info -> Advanced -> Cascades -> View Template Body tab.
The default view template title cascade consists of:
If the tiddler title starts with $:/ then use the template $:/core/ui/ViewTemplate/title/system which causes the $:/ prefix to be displayed in pale text
You can see the current settings for the view template title cascade in $:/ControlPanel under the Info -> Advanced -> Cascades -> View Template Title tab.
vis.js Timeline is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable timelines. This project is a direct continuation of emkay's plugin.
Most browsers provide Web Developer Tools that include a JavaScript console. In Chrome and Firefox it can be opened via the Tools menu, or by pressing Ctrl + Shift + J (Cmd + Shift + J on a Mac).
When running under Node.js, TiddlyWiki includes a simple HTTP/HTTPS web server that allows you to use it from any browser running on the same machine or over a network.
The web server includes a very simple mechanism allowing multiple users to log in with different credentials. The implementation is designed to be simple and easy to use, and would not generally be considered robust enough for use on the open internet. It is intended for use by individuals or small groups on a trusted network. It is recommended to use an external proxy before exposing it on the Internet.
How It Works
The web server listens for requests coming over the network, and performs the following actions in turn:
Authorization is the process of determining which resources may be accessed by a particular user. TiddlyWiki implements a simple scheme whereby read and write access to the wiki can be independently controlled.
Routing is the process of dispatching the request to the API handler, and returning any required data.
Visit http://127.0.0.1:8080/ to access the wiki. Access is anonymous, so anyone can read or write to the wiki.
This will typically be available only to users on the local machine. For information on how to open the instance to the local network see the Web Server host parameter entry.
Authenticated Access
Adding username and password parameters enforces basic authentication for both reading and writing:
Visiting the wiki will prompt for a username and password, and access is denied if they do not match the provided credentials.
Anonymous Read, Authenticated Write
This example adds the authorization parameters readers and writers to grant read access to anonymous users, but require authentication as "joe" in order to gain write access.
Note that anonymous users can trigger a username/password prompt by visiting the route \login-basic (eg http://127.0.0.1:8080/login-basic).
Anonymous access is only permitted if the special (anon) token is present in the readers (for reading) and optionally writers (for writing) authorisation parameters.
Gets an array of all raw non-system tiddlers, excluding the text field.
GET /recipes/default/tiddlers.json
Parameters:
filter - filter identifying tiddlers to be returned (optional, defaults to "[all[tiddlers]!is[system]sort[title]]")
exclude - comma delimited list of fields to excluded from the returned tiddlers (optional, defaults to "text")
In order to avoid denial of service attacks with malformed filters in the default configuration the only filter that is accepted is the default filter "[all[tiddlers]!is[system]sort[title]]"; attempts to use any other filter will result in an HTTP 403 error.
To enable a particular filter, create a tiddler with the title "$:/config/Server/ExternalFilters/" concatenated with the filter text, and the text field set to "yes". For example, the TiddlyWeb plugin includes the following shadow tiddler to enable the filter that it requires:
It is also possible to configure the server to accept any filter by creating a tiddler titled $:/config/Server/AllowAllExternalFilters with the text "yes". This should not be done for public facing servers.
The wiki is composed by rendering the tiddler identified in the root-tiddler parameter with the render type in the root-render-type parameter. This is then served with the content type from the root-serve-type parameter.
Authentication is the process of identifying the current user. TiddlyWiki supports three types of authentication:
Anonymous Access allows any user to access resources without requiring authentication. Optionally, a username can still be specified for signing edits
Basic Authentication requires the user to enter a username and password combination which TiddlyWiki validates against an internal database of credentials
Header Authentication requires an external proxy to place the username of the current user in a trusted header of the request. It is often used as the basis of "single sign-on" features
Authorization is the process of determining which resources may be accessed by a particular user. It occurs after authentication has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has administrator access to the server, and read and write access to a wiki.
The WebServer parameters admin, readers and writers each contain a comma separated list of principals (which is to say, either usernames or certain special tokens) which should have read or write access respectively.
The available special tokens are:
(anon) - indicates all anonymous users
(authenticated) - indicates all authenticated users
Admin Functions
The (anon) token is not valid for the admin parameter.
At this time, no server functions are restricted to admin authorized users in the unmodified Tiddlywiki server. Third party plugins can leverage this to restrict routes or commands to a subset of authorized users.
Read-only Mode
Read-only mode is engaged when the current user is not authorized to write to the current wiki.
User interface features concerned with creating or editing content are disabled in read-only mode:
clone, delete, new-here and new-journal-here tiddler toolbar buttons
import, manager, new-tiddlernew-image and new-journal page control buttons
Basic authentication is a standard mechanism for servers to instruct browsers to prompt the user for credentials. It is recommended to use it in association with HTTPS due to the way that it passes unencrypted passwords over the network.
Basic authentication is activated if credentials are specified via the username/password or credentials parameters.
If WebServer Authorization is configured to allow access by both anonymous and authenticated users then by default users will not be prompted for credentials, and will be given anonymous access. To force a password prompt visit the route /login-basic (for example, http://127.0.0.1:8080/login-basic).
Header authentication is commonly used for "single sign on" in corporate environments. When doing header authentication, the user is not prompted for a username and password on TiddlyWiki. Instead, the user is required to login at a SSO proxy server. When the user authenticates themselves to the SSO proxy server, the proxy server redirects the user request to the TiddlyWiki server with this additional request header containing the username. Then TiddlyWiki server is able to use the value of this request header to identify the user.
For example, if the authenticated-user-header is set to X-Authenticated-User, then the HTTP request must include a header field X-Authenticated-User with a value that is the username:
X-Authenticated-User: JeremyRuston
Depuis : 5.3.0 Value of this header field should be URI-encoded before transit on the client (using encodeURIComponent JS function or encodeuricomponent Operator), and will be URI-decoded by the server.
Setting csrf-disable to yes disables the CSRF checks; no (or any other value) enables them.
The only currently implemented check is the use of a custom header called x-requested-with that must contain the string TiddlyWiki in order for write requests to succeed.
127.0.0.1 (default) - only listens for connections from browsers on the same computer
0.0.0.0 - listens for connections on all network interfaces, and thus from any browser on a reachable network
n.n.n.n - listens for connections on the network interface with the specified IP address
Note: Using 0.0.0.0 or n.n.n.n in a public environment (e.g. coffee shop, library, airport) is inadvisable as it will expose your system to possible intrusion.
Depuis : 5.2.2 The web server configuration parameterrequired-plugins is used to specify the plugins required to start the WebServer. It take a comma seperated list of plugin titles. The WebServer will issue a warnign in the console if the required plugins are not loaded. This parameter defaults to $:/plugins/tiddlywiki/filesystem,$:/plugins/tiddlywiki/tiddlyweb.
The web server configuration parameterroot-serve-type determines the content type with which the root wiki tiddler is rendered. The default is text/html.
The web server configuration parameterroot-tiddler determines the title of the tiddler that is rendered as the root wiki. The default setting is $:/core/save/all.
The web server configuration parametersystem-tiddler-render-template is used to specify the template for serving system tiddlers in the read-only single tiddler view. The default value is $:/core/templates/wikified-tiddler which renders the tiddler raw, without any special viewing template.
This setting may be overwritten by specifying the _render_template field of a tiddler.
The web server configuration parametersystem-tiddler-render-type is used to specify the render type for serving system tiddlers in the read-only single tiddler view. The default value is text/plain, causing the raw text of rendered system tiddlers to be returned. Alternatively, text/html can be used to cause the full HTML of the rendered tiddlers to be returned.
This setting may be overwritten by specifying the _render_type field of a tiddler.
The web server configuration parametertiddler-render-template is used to specify the template for serving ordinary, non-system tiddlers in the read-only single tiddler view. The default value is $:/core/templates/server/static.tiddler.html which renders tiddlers in a lightweight page with a simple sidebar.
This setting may be overwritten by specifying the _render_template field of a tiddler.
The web server configuration parametertiddler-render-type is used to specify the render type for serving ordinary, non-system tiddlers in the read-only single tiddler view. The default value is text/html, causing the full HTML of the rendered output to be returned. Alternatively, text/plain can be used to cause the raw text of rendered system tiddlers to be returned.
This setting may be overwritten by specifying the _render_type field of a tiddler.
The optional web server configuration parametertls-cert contains the pathname to the certificate file required when running the web server under HTTPS. The pathname is taken relative to the wiki folder.
The optional web server configuration parametertls-key contains the pathname to the key file required when running the web server under HTTPS. The pathname is taken relative to the wiki folder.
Depuis : 5.2.2 The optional web server configuration parametertls-passphrase contains the "certificate passphrase", a string used to decrypt the certificate file used when running the web server under HTTPS.
Il faut savoir que la version courante de TiddlyWiki n'est pas entièrement rétro-compatible avec TiddlyWikiClassic. Le contenu peut être importé mais devra être ajusté pour s'adapter au nouveau format WikiText. Un plugin tw2parser permettant d'afficher fidèlement la plupart des contenus créés avec TiddlyWikiClassic est en cours de développement :
Variable attribute values are indicated with double angle brackets around a macro invocation. For example:
<div title=<<MyMacro "Brian">>>
...
</div>
The behaviour of variables invoked via widget attributes is not the same as when they are invoked via normal wikitext. In addition, the behaviour depends on how the variable is declared:
how declared
behaviour
\define
Textual substitution of parameters is performed on the body text. No further processing takes place. The result after textual substitution is used as the attribute's value
Body text is retrieved as-is and used as the attribute's value.
\function
When a function is invoked as <div class=<<macro>>/>, it is a synonym for <div class={{{[function[macro]]}}}/>. As with any filtered transclusion (i.e. triple curly braces), all results except the first are discarded. That first result is used as the attribute's value. Note that functions are recursively processed even when invoked in this form. In other words a filter expression in a function can invoke another function and the processing will continue
Filtered attribute values are indicated with triple curly braces around a Filter Expression. The value will be the first item in the resulting list, or the empty string if the list is empty.
Depuis : 5.2.2 To improve readability, newlines can be included anywhere that whitespace is allowed within filtered attributes.
This example shows how to add a prefix to a value:
Substituted attribute values can use two different styles of quoting:
Single backticks
attr=`value`
Triple backticks
attr=```value```
The value of the attribute will be the text denoted by the backticks with any of the placeholders for filter expressions and variables substituted with their corresponding values. Filter expression placeholders are substituted before variable placeholders, allowing for further variable substitution in their returned value.
Any other wiki syntax in that text will be left as-is.
placeholder syntax
description
$(varname)$
Text substitution of a variable. Undefined variables are replaced with an empty string.
${ filter expression }$
Text substitution with the first result of evaluating the filter expression.
Examples
Substituting a variable value into a string
<$text text=`Hello there this is the tiddler "Substituted Attribute Values"`/>
Affichera ceci :
Hello there this is the tiddler "Substituted Attribute Values"
Substituting a variable value and the result of evaluating a filter expression into a string
<$text text=`This tiddler is titled "Substituted Attribute Values" and was last modified on ${[{!!modified}format:date[DDth MMM YYYY]]}$`/>
Affichera ceci :
This tiddler is titled "Substituted Attribute Values" and was last modified on 15 juin 2023
Concatenating strings and variables to create a URL
<$let hash={{{ [<currentTiddler>encodeuricomponent[]] }}}>
<a href=`http://tiddlywiki.com/#`>this tiddler on tiddlywiki.com</a>
</$let>
an overview of attributes and how the widget content is handled
more detailed attribute explanation when required
examples
The Content and Attributes section should describe how the content of the widget is used, followed by a table of the possible attributes, each with a short description of a single sentence. The attribute names in the table and elsewhere in the tiddler should be rendered with the .attr macro. The .from-version macro should be used as first item in the description to designate the version at which a parameter became available.
A subsection should be used for parameters that need an extended description, possibly with separate examples. When there are more than 2 such subsection necessary, the subsections should be split into their own tiddlers, and the .doc-tabs macro should be used to transclude them into the widget documentation tiddler as tabs.
The .doc-tabs macro is used without parameters
The .doc-tabs macro must not be used more than once within a single documentation tiddler
The tiddlers to be included in the tab group should be tagged with the respective widget documentation tiddler and have a description field set to tab
The caption contains the tab button text. It should be as short as possible. For the attribute name, the .attr macro should be used in the caption
The tab tiddlers should start with a level-2-heading that links to itself, so that they may be opened from within the tabs
They can contain examples if these are specific to the topic of the subsection
In the attribute table, the .widget-attr-link macro can be used to turn attributes into a button that activates the respective tab. The .widget-attr-link macro is used like this
<<.widget-attr-link text:<display text> target:<title of corresponding tiddler> >>
Elsewhere, the .doc-tab-link macro can be used to activate the respective tab
<<.doc-tab-link text:<display text> target:<title of corresponding tiddler> tooltip:<tooltip to show when hovering over the button> class:<additional classes> >>
The parameters tooltip and class are optional.
Both link macros scroll to the tab group additionally to setting the selected tab. They can also be used within the tab contents tiddlers themselves. If a tab tiddler is opened outside the tab group, doc-tab-link will open the tiddler containing the tab group if it is not yet open, and scroll to its tab group if it is.
The tm-browser-refresh message refreshes the page, causing the re-initialisation of any plugin tiddlers. It does not require any properties on the event object.
The refresh message is usually generated with the ButtonWidget and is handled by the core.
The tm-clear-password message clears the current password from the password vault, clearing the $:/isEncrypted tiddler. See EncryptionMechanism for details.
This message is typically generated with the ButtonWidget, and is handled by the core itself.
The tm-close-all-windowsmessage closes all additional browser window that were opened with tm-open-window.
The tm-close-window message is best generated with the ActionSendMessageWidget, which in turn is triggered by a widget such as the ButtonWidget. It is handled by the core itself.
<$button>Close All Windows
<$action-sendmessage
$message="tm-close-all-windows"
/>
</$button>
The tm-close-windowmessage closes an additional browser window that was opened with tm-open-window. Specify which window to close by setting the value of param to the string used as windowID when opening the window.
Name
Description
param {default param}
String used as windowID when opening the window
The tm-close-window message is best generated with the ActionSendMessageWidget, which in turn is triggered by a widget such as the ButtonWidget. It is handled by the core itself.
If the windowID parameter was used with tm-open-window when opening a new window, the value of windowID is available within that window in the variable tv-window-id
<$button>Open Window
<$action-sendmessage
$message="tm-open-window"
$param="$:/temp/openme"
template="SampleWindowTemplate"
windowTitle="My Window Title"
width="400"
height="500"
windowID="window1"
something="I just flew in on a variable, and boy is my Hashmap tired." />
</$button>
<$button>Close Window
<$action-sendmessage
$message="tm-close-window"
$param="window1"
/>
</$button>
The tm-delete-tiddler message deletes the specified tiddler and removes it from the current story. If the tiddler is a draft then it also deletes the tiddler specified in the draft.of field. The delete tiddler message requires the following properties on the event object:
Name
Description
param
Title of the tiddler that is to be deleted
tiddlerTitle
Fallback title that is used if param isn't specified (automatically set by the ButtonWidget)
The delete tiddler message is usually generated with the ButtonWidget and is handled by the NavigatorWidget.
The download file message causes the current saver module to prompt the user to download the result of parsing a specified template tiddler as a file. It requires the following properties on the event object:
Name
Description
param
Title of a tiddler to use as a template for the new tiddler
{any other params}
Any other parameters are made available as variables within the context of the widget message.
The following variable names have special behaviour:
Name
Description
filename
Filename for the downloaded file (note that this is a hint to the browser, and the actual filename used may be different)
The download file message is usually generated with the ButtonWidget.
A tm-edit-bitmap-operation invokes one of the available operations on a surrounding bitmap editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the event object are required:
Name
Description
param
Name of the operation to be executed, see below for a list of possible operations
{any other params}
Any other parameters are made available as variables within the context of the widget message.
The tm-edit-bitmap-operation message is usually generated by a ButtonWidget or an ActionWidget and is handled by the surrounding bitmap editor.
Bitmap Operations
At this point the following bitmap operations have been implemented:
Name
Description
resize
Resizes the image to the specified width and height. Parameters include:
Name
Description
width
Specifies the width the image is resized to
height
Specifies the height the image is resized to
clear
Clears the contents of the image and fills it with a solid colour. Parameters include:
Name
Description
colour
Colour the image should be filled with, defaults to White
The colour field can take any normal CSS colour value, including the hexadecimal representation or the RGB format.
A tm-edit-text-operation invokes one of the available operations on a surrounding text editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the event object are required:
Name
Description
param
Name of the operation to be executed, see below for a list of possible operations
{any other params}
Any other parameters are made available as variables within the context of the widget message.
The tm-edit-text-operation message is usually generated by a ButtonWidget or an ActionWidget and is handled by the surrounding text editor.
Text Operations
At this point the following text operations have been implemented:
Name
Description
excise
Excises the currently selected text into a new tiddler and replaces it with a link, a macro or a transclude of the new tiddler. Parameters include:
Name
Description
title
Title of the new tiddler the selected content is excised to
type
Type of the replacement to be inserted: Can be one of transclude, link or macro
macro
In case type=macro, specifies the name of the macro to be inserted. The title of the new tiddler is provided as the first parameter to the macro. Defaults to the translink macro
tagnew
If 'yes', will tag the new tiddler with the title of the tiddler currently being edited
replace-all
Replaces all contents of the editor with the provided text.
Name
Description
text
Text to be inserted
replace-selection
Replaces the current selection with the provided text.
Name
Description
text
Text to be inserted
prefix-lines
Prefixes the currently selected line(s) with the provided character. If a line is already prefixed by the provided prefix, the prefix is removed instead.
Name
Description
character
Prefix character
count
Number of characters that make up the prefix
Example Setting character="!" and count="3" would insert the prefix "!!!", which will resolve to a subheading when parsed as WikiText.
wrap-lines
Surrounds the selected lines with the provided prefix and suffix.
Name
Description
prefix
String to be prefixed to the selected lines
suffix
Suffix to be inserted after the selected lines
wrap-selection
Surrounds the current selection with the provided prefix and suffix.
Name
Description
prefix
String to be prefixed to the selection
suffix
Suffix to be inserted after the selection
save-selection
Saves the text of the current selection into the provided tiddler and field.
Name
Description
tiddler
Tiddler title to which the selection will be saved
field
Field name (defaults to "text")
make-link
Creates a wiki text link to the tiddler specified in text. If there is a selection, it is used as the text of the link.
Name
Description
text
Tiddler title to which the link will be created
insert-text
Inserts the text specified in text at the caret position. If there is a selection, it is replaced.
The tm-edit-tiddler message replaces the specified tiddler in the current story with a draft version of itself. It requires the following properties on the event object:
Name
Description
param
Title of the tiddler that is being switched to edit mode
tiddlerTitle
Fallback title that is used if param isn't specified (automatically set by the ButtonWidget)
The tm-fold-all-tiddlers message folds all tiddlers in the current story list.
Internally, it sets the text of all of the state tiddlers corresponding to tiddlers in the story river to "hide". The state tiddler titles are formed by prefixing the tiddler title with a prefix that defaults to $:/state/folded/.
Name
Description
foldedStatePrefix
Prefix for the state tiddler in which the fold state is stored. Defaults to $:/state/folded
The tm-fold-all-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-fold-other-tiddlers message folds all tiddlers in the current story list, except the one specified in the param parameter. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
Name
Description
param
Title of the tiddler that should be ignored by the fold operation.
foldedStatePrefix
Prefix for the state tiddler in which the fold state is stored.
The core uses a foldStatePrefix of $:/state/folded/ to store the fold states for the default story view.
The state tiddlers title is computed as foldStatePrefix + TiddlerTitle. If the foldStatePrefix is not set, it will overwrite the text of the tiddler(s) itself, resulting in data loss.
The tm-fold-other-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-fold-tiddler message toggles the value of a state tiddler. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
Name
Description
param
ignored ... foldedState must be used
foldedState
State tiddler in which the fold state is stored
The core uses a foldState prefix of $:/state/folded/ + tiddler title to store the fold states for the default story view.
The tm-fold-tiddler message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The core $:/core/ui/ViewTemplate defines a global variable folded-state, that is used with every tiddler. It's created like this:
The fullscreen message is used to enter, exit or toggle the "fullscreen" mode of the browser, if it supports it. It uses the following properties on the event object:
Name
Description
param
enter to enter full screen mode, exit to exit it, otherwise toggle the full screen status
The fullscreen message is handled by the TiddlyWiki core.
<$button message="tm-full-screen">
Full screen toggle
</$button>
<$button message="tm-full-screen" param="enter">
Full screen enter
</$button>
<$button message="tm-full-screen" param="exit">
Full screen exit
</$button>
Le message tm-home ferme tous les tiddlers ouverts et réouvre les tiddlers par défaut définis dans $:/DefaultTiddlers. Il élimine aussi toute trace de permalien de la barre d’adresse du navigateur internet. Il ne requiert aucune propriété dans l’objet event.
Le message est habituellement lancé à travers le ButtonWidget et est pris en charge par le noyau.
The tm-import-tiddlers message inserts a list of tiddlers into the pending import tiddler $:/Import. It also applies any active upgrader modules to each tiddler as it arrives (see the UpgradeMechanism for more details).
Name
Description
param
JSON text of the array of tiddlers to be imported
autoOpenOnImport
Depuis : 5.1.23 Optional value "no" or "yes" that can override tv-auto-open-on-import
importTitle
Depuis : 5.1.23 optional tiddler title to use for import process instead of $:/Import
Usually a plugin library has to be loaded (initialized) first before it can be used. If the plugin library specified by 'url' has not been initialized yet, it will be loaded and initialized.
The tm-load-plugin-from-library message is usually generated with the ButtonWidget and is handled by the core itself.
The tm-load-plugin-library message loads the specified plugin library and imports information about the contained plugins in temporary tiddlers.
Name
Description
url
Url specifying the plugin library to be loaded.
infoTitlePrefix
Prefix to the temporary tiddlers being created, containing information about the plugins the plugin library offers. Defaults to $:/temp/RemoteAssetInfo/
Example
The following snippet will load the official plugin library:
<$button>
<$action-sendmessage $message="tm-load-plugin-library" infoTitlePrefix="$:/temp/RemoteAssetInfo/" url="https://tiddlywiki.com/library/v5.1.11/index.html"/>
Load official plugin library
</$button>
The tm-load-plugin-library message is usually generated with the ButtonWidget and is handled by the core itself.
The login message prompts the user for a username and password and attempts to login to the current serverside host. The tiddler $:/status/IsLoggedIn reflects the current login status with the values "yes" or "no", and $:/status/UserName reflects the current username.
The login message is handled by the TiddlyWiki core SyncMechanism which invokes the current SyncAdaptorModule (typically the tiddlywiki/tiddlywebadaptor plugin).
Depuis : 5.1.23 The login message can optionally accept parameters called username and password that immediately attempts to login with the specified credentials without displaying the prompt
The logout message attempts to log the user out of the current serverside host. The tiddler $:/status/IsLoggedIn reflects the current login status with the values "yes" or "no", and $:/status/UserName reflects the current username.
The logout message is handled by the TiddlyWiki core SyncMechanism which invokes the current SyncAdaptorModule (typically the tiddlywiki/tiddlywebadaptor plugin).
The "currentTiddler" variable is set to the title of the modal tiddler, but can be overridden by specifying a different value in paramObject.
Example
Here is an example of displaying a modal and passing parameters to it:
(Note how all parameters to action-sendmessage other than $param and $message are available as variables within the modal.)
Depuis : 5.1.18 if triggered from within a new window, the above examples will be displayed within that window. The rootwindow attribute can be set to yes or true to inherit this behavior and to display the Modal within the root window
Depuis : 5.1.23 Links to tiddlers within a modal will open in the same story as the widget that sent the tm-modal message. You can override this by specifying values for the variables tv-story-list and tv-history-list when sending the tm-modal message.
The tm-navigate message inserts the specified tiddler into the story and puts it at the top of the history stack. If the tiddler is not already present in the story then it will be positioned immediately after the tiddler specified in event.navigateFromTitle.
The navigate message requires the following properties on the event object:
Name
Description
navigateTo
Title of the tiddler that is being navigated
navigateFromTitle
Title of the tiddler from which the navigation was initiated
navigateFromClientRect
Bounding rectangle in client page coordinates of the element initiating the navigation
navigateFromClientTop
Y coordinate of top edge of bounding client rectangle
navigateFromClientLeft
X coordinate of left edge of bounding client rectangle
navigateFromClientWidth
Width of bounding client rectangle
navigateFromClientRight
X coordinate of right edge of bounding client rectangle
navigateFromClientBottom
Y coordinate of bottom edge of bounding client rectangle
navigateFromClientHeight
Height of bounding client rectangle
navigateSuppressNavigation
true causes the new tiddler to only be added to the story, and not the history stack. This suppresses the scrolling associated with navigating to a tiddler
To create a new tiddler with explicit parameters rather than by cloning a template tiddler:
<$button>
<$action-sendmessage $message="tm-new-tiddler" title="This is newly created tiddler" tags="OneTag [[Another Tag]]" text=<<now "Today is DDth, MMM YYYY">>/>
New Tiddler
</$button>
To create a new tiddler from a template with additional parameters:
<$button>
<$action-sendmessage $message="tm-new-tiddler" $param=<<currentTiddler>> fieldname="field value"/>
New Tiddler
</$button>
```
The notify message briefly displays a specified tiddler as a small alert in the upper right corner of the page. It requires the following properties on the event object:
Name
Description
param
Title of the tiddler to be displayed
{any other params}
Any other parameters are made available as variables to the notify message.
The notify message is handled by the TiddlyWiki core.
The tm-open-external-window message opens an external link eg: "https://tiddlywiki.com" in a new browser window. If no parameters are specified, it opens the help tiddler. Any additional parameters passed via the paramObject are being provided as variables to the new window.
Name
Description
param
URL of the tiddler to be opened in a new browser window, defaults to the TiddlyWiki help
{any other params}
Any other parameters are made available as variables to the window. See below.
parmObject
Name
Description
Important
windowName
If a parameter is provided it can be used to open different links in the same window eg: _tiddlywiki. Default is empty, so every link opens a new window.
The behaviour is influenced by user settings in the browser and the browsers default behavior!
windowFeatures
This parameter needs to be provided as a single string. eg: "height=400, width=600". For detailed description about possible parameters see: Mozilla Help
The tm-open-external-window message is usually generated with the ButtonWidget or ActionSendMessageWidget and is handled by the core itself.
Examples
<$button>
<$action-sendmessage $message="tm-open-external-window" $param="https://tiddlywiki.com" windowName="_tiddlywiki" windowFeatures="height=500, width=900"/>
Open ~TiddlyWiki - Action
</$button>
<$button>
<$action-sendmessage $message="tm-open-external-window" $param="https://developer.mozilla.org/en-US/docs/Web/API/Window/open" windowName="_tiddlywiki" windowFeatures="height=400, width=600"/>
Open Mozilla Help - Action
</$button>
<$button message="tm-open-external-window" param="https://tiddlywiki.com" >
Open ~TiddlyWiki - Button
</$button>
The tm-open-windowmessage opens a tiddler in a new browser window. If no parameters are specified, the current tiddler is opened in a new window. Similiar to tm-modal any additional parameters passed via the paramObject are provided as variables to the new window.
Name
Description
param {default param}
Title of the tiddler to be opened in a new browser window, defaults to currentTiddler if empty
template
Template in which the tiddler will be rendered
windowTitle
Title string for the opened window
width
Width of the new browser window
height
Height of the new browser window
left
Depuis : 5.2.2 Optional, left position of new browser window
top
Depuis : 5.2.2 Optional, top position of new browser window
windowID
Depuis : 5.2.2 Optional, unique string used to identify the widow. Can be used with WidgetMessage: tm-close-window to close the window. Defaults to the value of param
{any other params}
Any other parameters are made available as variables within the new window
The tm-open-window message is best generated with the ActionSendMessageWidget, which in turn is triggered by a widget such as the ButtonWidget. The message is handled by the core itself.
Depuis : 5.2.2 To open a tiddler in more than one new window, use a unique value for windowID
<$button>Open Window
<$action-sendmessage
$message="tm-open-window"
$param="$:/temp/openme"
template="SampleWindowTemplate"
windowTitle="My Window Title"
width="640"
height="480"
something="This is my new window. There are many like it, but this one is mine." />
</$button>
The perform import message copies tiddlers from a specified plugin into the main store. See the UpgradeMechanism for an overview of how it is used by the core.
Name
Description
param
Title of the pending import tiddler. Defaults to $:/Import
To select which tiddlers are to be imported, fields with names formed from selection- plus the title of the tiddler are used. The value unchecked causes the tiddler to be skipped from the import.
The perform import message is usually generated with the ButtonWidget and is handled by the NavigatorWidget.
The tm-permalink message changes the browser address bar to form a permalink to a specified tiddler, defaulting to the current tiddler. The resulting link will be copied to the clipboard.
The permalink message supports the following properties on the event object:
Name
Description
param
Title of the tiddler to be permalinked
tiddlerTitle
The current tiddler (used by default if the tiddler title isn't specified in the param)
The permalink message can be generated by the ButtonWidget, and is handled by the story mechanism.
The tm-permaview message changes the browser address bar to form a permaview that specifies all the open tiddlers in the main story river, and the tiddler to be navigated, defaulting to the current tiddler.
The permaview message supports the following properties on the event object:
Name
Description
param
Title of the tiddler to be navigated within the permaview
tiddlerTitle
The current tiddler (used by default if the tiddler title isn't specified in the param)
The permaview message can be generated by the ButtonWidget, and is handled by the story mechanism.
Depuis : 5.1.14 The tm-print message causes the browser to display the print dialog for the current page. It does not require any properties on the event object.
The print message is usually generated with the ButtonWidget and is handled by the core.
Depuis : 5.2.2 The tm-relink-tiddler message relinks a tiddler by deleting it and recreating it with a new title. Unlike the WidgetMessage: tm-rename-tiddler message, this message does not rename the tiddler, it just relinks the references to it.
The relink tiddler message requires the following properties on the event object:
Name
Description
from
Current title of tiddler
to
New title of tiddler
renameInTags
Optional value "no" to disable renaming in tags fields of other tiddlers (defaults to "yes")
renameInLists
Optional value "no" to disable renaming in list fields of other tiddlers (defaults to "yes")
The relink tiddler message is usually generated with the ButtonWidget and is handled by the core.
Examples
To relink Tiddler1 to Tiddler2 in tags and list fields of other tiddlers:
The tm-rename-tiddler message renames a tiddler by deleting it and recreating it with a new title. The rename tiddler message requires the following properties on the event object:
Name
Description
from
Current title of tiddler
to
New title of tiddler
renameInTags
Depuis : 5.1.23 Optional value "no" to disable renaming in tags fields of other tiddlers (defaults to "yes")
renameInLists
Depuis : 5.1.23 Optional value "no" to disable renaming in list fields of other tiddlers (defaults to "yes")
To rename a tiddler called Tiddler1 to Tiddler2 and respect the setting in the tiddler $:/config/RelinkOnRename for whether to rename Tiddler1 in tags and list fields of other tiddlers:
The tm-save-tiddler message is applied to draft tiddlers. It saves the draft over the tiddler identified in the draft.of field and then deletes the draft. The save tiddler message requires the following properties on the event object:
Name
Description
param
Title of the tiddler that is being switched out of edit mode
tiddlerTitle
Fallback title that is used if param isn't specified (automatically set by the ButtonWidget)
The save wiki message causes the current saver module to perform a full save operation. The save operation can involve user interaction. It requires the following properties on the event object:
Name
Description
param
Title of a tiddler to use as a template for rendering the wiki (defaults to $:/core/save/all)
{any other params}
Any other parameters are made available as variables to use for the rendering.
The save wiki message is usually generated by the ButtonWidget.
The tm-scroll message causes the surrounding scrollable container to scroll to the specified DOM node into view. The tm-scroll is handled in various places in the core itself, but can also be handled by a ScrollableWidget.
Name
Description
target
Target DOM node the scrollable container should scroll to (note that this parameter can only be set via JavaScript code)
selector
Depuis : 5.1.23 Optional string CSS selector as an alternate means of identifying the target DOM node
animationDuration
Depuis : 5.2.2 Optional number specifying the animation duration in milliseconds for the scrolling. Defaults to the global animation duration.
Set animationDuration to 0 to scroll without animation
The server refresh message attempts to synchronise the latest changes to the current serverside host.
The server refresh message is handled by the TiddlyWiki core SyncMechanism which invokes the current SyncAdaptorModule (typically the tiddlywiki/tiddlywebadaptor plugin).
The tm-set-password message prompts the user for a new password and stores it in the password vault, replacing any existing password. It also sets the $:/isEncrypted tiddler. See EncryptionMechanism for details.
This message is typically generated with the ButtonWidget, and is handled by the core itself.
The tm-unfold-all-tiddlers message unfolds all tiddlers in the current story list. It does so by setting the text of all state tiddlers to: "show".
Name
Description
foldedStatePrefix
Prefix for the state tiddler in which the fold state is stored.
The core uses a foldStatePrefix of $:/state/folded/ to store the fold states for the default story view.
The state tiddlers title is computed as foldStatePrefix + TiddlerTitle. If the foldStatePrefix is not set, it will overwrite the text of the tiddler(s) itself, resulting in data loss.
The tm-unfold-all-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
L'affichage de TiddlyWiki est piloté par un ensemble de widgets sous-jacents. Ceux-ci sont organisés dans une structure arborescente : chaque widget a un widget parent et zéro ou plusieurs widgets enfants.
TiddlyWiki génère cet arbre widget par l'analyse WikiText des tiddlers. Chaque composant de la syntaxe WikiText, y compris le cas trivial du texte ordinaire, génère le widget correspondant. L'arborescence widget est une représentation intermédiaire, rendue, par la suite, dans l'affichage réel final.
Les Widgets sont similaires aux éléments HTML d'un document. En fait, les balises HTML dans Wikitext génèrent des éléments widgets dédiés.
Les widgets enrichissent les fonctionnalités du WikiTexte. Ils ont la même syntaxe que les éléments HTML, mais leur nom de balise commence toujours par $. Par exemple :
<$button message="tm-close-tiddler">Fermez Moi !</$button>
Notez que les widgets héritent de toutes les caractéristiques du HTML dans le WikiTexte :
Les attributs des widgets peuvent être spécifiés via :
Des chaînes non-cotées (si elles ne contiennent pas d'espace)
Des chaînes cotées par simple ' ou double " cotes
Des chaînes cotées par des doubles cotés triplées """
Des appels de Macro (c-à-d attr=<<maMacro>>)
Des transclusions (eg, attr={{MonTiddler!!champ}})
Le contenu d'un widget est analysé en mode en ligne sauf si la balise d'ouverture est suivie par deux sauts de ligne, ce qui force le mode bloc.
Le mode en ligne signifie que les règles d'analyse en mode bloc comme les rubriques, les tables, les listes, ... ne sont pas reconnues.
Les groupes de tiddlers à intitulé unique sont contenus dans des objets WikiStore.
Le WikiStore gère également les modules de plugin utilisés pour les widgets, les opérations comme la sérialisation, la désérialisation, l'analyse et le rendu tiddlers.
"Wikification" is a general term for the dynamic process of converting tiddlers containing WikiText into the HTML DOM representation needed by the browser, and updating that representation if the underlying tiddlers change.
It is composed of several distinct steps:
ParserMechanism: reading the text of tiddlers and scanning for wikitext constructions, outputting a tree representation of the resulting structure. It is an expensive process so parse trees are cached, and only need to be updated if the corresponding tiddler is changed
WidgetMechanism: starting with a specified root tiddler, recursively instantiate a widget for each parse tree node making a rendering tree. Widgets can optionally also create DOM nodes
RefreshMechanism: handling changes to the tiddler store by selectively and efficiently updating a rendering tree
This mechanism is used in the browser to build TiddlyWiki's main interactive page. At startup, the tiddler $:/core/ui/PageTemplate is parsed and rendered to the DOM, recursively pulling in other tiddlers to build the entire user interface. Any user interactions – following a link, clicking a button, or typing in a text box – trigger a change in the tiddler store which then automatically propagates through the widget tree. For example, if the user clicks a link to navigate to a new tiddler, the following steps take place:
Clicking the link triggers the action of the LinkWidget which by default is to add the target tiddler to the list field of the tiddler $:/StoryList
The modification to the tiddler store asynchronously triggers the refresh cycle. The asynchronous triggering ensures that the refresh cycle is only run once even if multiple tiddlers were modified in succession
The refresh cycle recursively visits each node of the render tree giving them the chance to update themselves in the light of the accumulated changes to the tiddler store. In this case, the ListWidget of the main story river notices that a single tiddler needs to be added to the river, and renders that newly displayed tiddler without disturbing the other tiddlers
The performance of the entire wikification process is critical. If the refresh cycle takes more than about 400ms then the user will notice a delay between their actions and the effects. See Performance for some discussion of how to optimise performance.
The rendering process is also aggressively reused in other parts of TiddlyWiki, both in the browser and on the server:
Generating TiddlyWiki's standalone HTML representation
The wikify widget parses and renders a string of text and assigns the result to a specified variable. The new value of the variable is available to the content within the wikify widget.
Content and Attributes
The content of the <$wikify> widget is the scope for the value assigned to the variable.
Attribute
Description
name
The name of the variable to assign
text
The text to parse and render
type
The ContentType of the text (defaults to text/vnd.tiddlywiki)
Le WikiTexte est le langage de balisage de TiddlyWiki, qui permet d'écrire de manière concise et expressive une grande variété de formatages de texte, de liens hypertextes et de fonctionnalités interactives. Il permet de se concentrer sur l'écriture, sans l'interférence d'une interface complexe. Il est conçu pour être familier aux utilisateurs de Markdown, tout en étant plus focalisé sur les liens et les fonctionnalités interactives.
La Editor toolbar permet d'insérer des balises de WikiTexte dans le texte du tiddler en cours d'édition.
Voici un diagramme approximatif dont les lignes correspondent globalement aux transitions entre modes d'analyse de l'interpréteur décrites ci-dessous :
Au début du texte, l'interpréteur cherche des pragmas. S'il n'en trouve aucun il bascule en mode en ligne ou en mode bloc, en fonction du mode de transclusion. S'il a trouvé un pragma, il continue à en chercher d'autres jusqu'à ce qu'il rencontre une ligne vide non suivie par le début d'un nouveau pragma.
Transitions depuis le mode bloc
Quand l'interpréteur rencontre la plupart des syntaxes de début de mode bloc, il bascule en mode en ligne, ce qui signifie que le texte compris entre des balises de début et de fin de bloc sera interprété en mode en ligne.
La « balise » de début de paragraphe est « invisible ». Même au sein des paragraphes l'interpréteur bascule en mode en ligne.
Il y a toutefois quelques balises de blocs dont le contenu est interprété en mode bloc :
Pour ces cas particuliers, lorsque la syntaxe de début de bloc est rencontrée, l'interpréteur continue à analyser le texte en mode bloc.
Les lignes horizontales sont un autre cas particulier : elles n'incluent pas de texte, donc l'interpréteur n'a pas l'opportunité de basculer en mode en ligne.
Les balises d'ouverture de widgets ou de HTML peuvent conduire l'interpréteur à changer de mode. Quand une de ces balises n'est pas suivie d'une ligne vide, le texte compris entre les balises sera interprété en mode en ligne. Voir les exemples HTML.
Transitions depuis le mode en ligne
L'interpréteur retourne en mode bloc après la fin d'une ligne qui termine du WikiTexte de mode bloc. En d'autres termes, quand la balise de fin de bloc est rencontrée.
Quand une balise d'ouverture de widget ou de HTML est suivie d'une ligne vide, le contenu est analysé en mode bloc. Voir les exemples HTML.
<div>
* La ligne vide après la balise ouvrante permet
* aux marqueurs de mode bloc (comme cette liste)
* d'être reconnus
</div>
Affichera ceci :
La ligne vide après la balise ouvrante permet
aux marqueurs de mode bloc (comme cette liste)
d'être reconnus
L'astuce de la ligne vide fonctionne aussi au sein des syntaxes reconnues seulement en mode en ligne (comme Mise en forme en WikiTexte) :
''<div>
* premier élément de la liste
* deuxième élément de la liste
</div>''
Affichera ceci :
premier élément de la liste
deuxième élément de la liste
<div>
* Une balise ouvrante non suivie d'une ligne vide
* signifie que la syntaxe en mode bloc (cette liste)
* ne sera PAS reconnue.
Les paragraphes ne sont reconnus qu'en mode bloc. Même avec des lignes vides, aucun nouveau paragraphe n'est reconnu.
Ceci n'est pas un nouveau paragraphe non plus.
</div>
Affichera ceci :
* Une balise ouvrante non suivie d'une ligne vide
* signifie que la syntaxe en mode bloc (cette liste)
* ne sera PAS reconnue.
Les paragraphes ne sont reconnus qu'en mode bloc. Même avec des lignes vides, aucun nouveau paragraphe n'est reconnu.
Ceci n'est pas un nouveau paragraphe non plus.
Les Tableaux en WikiTexte sont des éléments pour lesquels l'astuce de la ligne vide ne fonctionne pas. Pour que l'interpréteur reconnaisse une ligne de tableau, elle doit remplir exactement une ligne de texte.
Ajouter une ligne blanche après une balise ouvrante au sein d'une cellule de tableau répartit la ligne de tableau sur plusieurs lignes de texte, et l'interpréteur ne peut plus reconnaître ce texte en tant que ligne de tableau.
|la ligne de tableau|entièrement sur|une ligne de texte|est reconnue|
Affichera ceci :
la ligne de tableau
entièrement sur
une ligne de texte
est reconnue
|Avec une ligne vide après une balise ouvrante|<div>
* la liste est reconnue
* mais pas le tableau autour
</div>|
Notez que le widget $macrocall ne dispose pas d'un attribut mode similaire, et le contenu des définitions de macros ne peut être analysé qu'en mode en ligne.
Bien que moins pratiques, les balises html <table>, <tr>, <td> peuvent être utilisées comme un moyen sûr de faire reconnaître les syntaxes en mode bloc à l'intérieur d'un tableau.
<table>
<tr><td>
* premier élément de la liste
* deuxième élément de la liste
</td><td>
|tableau|imbriqué|
</td></tr>
</table>
Dans le code ci-dessus, la syntaxe de liste à puce est reconnue en mode bloc, puis son contenu est interprété en mode en ligne. Quand l'interpréteur rencontre un appel de macro en WikiTexte il utilise le mode courant pour analyser le contenu de la macro. La macro d'exemple contient une définition de table qui n'est reconnue qu'en mode bloc.
De ce fait, dans la ligne n°1 ci-dessus, la syntaxe de table n'est pas reconnue. Dans la ligne n°2, la ligne vide après la balise <div> bascule l'interpréteur en mode bloc et le contenu de la macro en hérite, donc la table est reconnue.
En utilisant le Widget macrocall, le mode d'analyse reste le mode en ligne (exemples des lignes n°3 et 4 ci-dessus) jusqu'à ce que la balise ouvrante soit suivie d'une ligne vide (exemple n°5 ci-dessus).
Parmi ces exemples, seuls les deux widgets $macrocall dont la balise d'ouverture n'est pas suivie d'une ligne vide (lignes n°3 et 4) sont analysés en mode en ligne.
Dans le code ci-dessus, la syntaxe de liste à puce est reconnue en mode bloc, puis son contenu est interprété en mode en ligne. Quand l'interpréteur rencontre une Transclusion en WikiTexte il utilise le mode courant pour analyser le contenu du tiddler transclus. Le tiddler d'exemple contient une définition de table qui n'est reconnue qu'en mode bloc.
De ce fait, dans la ligne n°1 ci-dessus, la syntaxe de table n'est pas reconnue. Dans la ligne n°2, la ligne vide après la balise <div> bascule l'interpréteur en mode bloc et le contenu transclus en hérite, donc la table est reconnue.
En utilisant le Widget Transclude, le mode d'analyse reste le mode en ligne (exemples des lignes n°3 et 4 ci-dessus) jusqu'à ce que la balise ouvrante soit suivie d'une ligne vide (exemple n°5 ci-dessus).
Pour voir d'autres exemples similaires, consultez Modes d'analyse du WikiTexte : exemples de macros. La seule différence est qu'ici l'exemple de la ligne n°6 utilise l'attribut mode du widget $transclude pour forcer explicitement le mode d'analyse plutôt que de de laisser le contenu de la balise le déterminer.
Dans les exemples suivants, les transclusions sont directes, au lieu d'être incluses dans des listes à puces :
Parmi ces exemples, seuls les deux widgets $transclude dont la balise d'ouverture n'est pas suivie d'une ligne vide ainsi que l'appel qui comporte l'attribut mode=inline (lignes n°3, 4 et 6) sont analysés en mode en ligne.
Pour afficher les tiddlers (généralement le champ text), l'interpréteur de WikiTexte lit et analyse le contenu, et applique les règles de conversion du WikiTexte. L'interpréteur a trois modes d'analyse :
Le concept de modes « bloc » et « en ligne » existe aussi pour les éléments HTML standards. En HTML, ces deux modes de mise en page(en anglais) déterminent si le résultat est disposé sur une même ligne ou pas.
Sous Windows il est possible de convertir TiddlyWiki en une vraie application locale en renommant le fichier HTML pour lui donner l'extension *.hta. Le module fsosaver peut alors utiliser l'ActiveX FileSystemObject pour enregistrer les modifications.
Notez qu'un inconvénient de cette méthode est que le fichier TiddlyWiki est enregistré avec l'encodage de caractères UTF-16, ce qui double quasiment sa taille par rapport au format UTF-8 habituel. Toutefois, ouvrir puis enregistrer le fichier avec une autre méthode le ré-encodera en UTF-8.
Xememex is a multiuser TiddlyWiki from Federatial. It allows large groups of people to work together on intertwingled wikis that can share content. It is implemented as a serverless application on Amazon Web Services.
The largest customer implementation has hundreds of online wikis with thousands of users. See https://manuals.annafreud.org/
Xememex is currently only available under commercial terms from Federatial. Contact Jeremy Ruston at Federatial for more details.
The XLSX Utilities edition of TiddlyWiki contains tools to work with .XLSX spreadsheets generated by applications like Microsoft Excel and Google Sheets. It can be used in the browser or under Node.js.